From 568b5341b5f3151e4275df89d7d0bbc0e2e19177 Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 4 Sep 2026 13:33:26 +0000 Subject: [PATCH] fix(cli): drop the deleted apps/cloud path from the publish help example `os package publish --help` printed its local-dev example as: $ OS_CLOUD_URL=http://localhost:4000 os package publish # local dev (apps/cloud) `apps/cloud` was deleted from this repository -- the reference cloud host now lives in `objectstack-ai/cloud` -- so the parenthetical told a user to run something against a directory absent from the tree they cloned. Unlike the source comments swept alongside it, this string is user-facing output: `static override examples` is printed verbatim by oclif under EXAMPLES. The parenthetical is dropped rather than re-pointed at the other repo. The example teaches that `OS_CLOUD_URL` overrides the control-plane URL, which the `--server` flag documents a few lines above in the same output; which directory happens to serve `localhost:4000` was never part of that, and a `--help` reader is not looking for a file in a monorepo. Two things on the tree already spell it that way: `content/docs/deployment/cli.mdx` publishes this same example with no directory, and the sibling `os plugin publish` gives the identical env-override example with no trailing comment at all. No behaviour moves: no flag, argument, default or exit code changes. Co-Authored-By: Claude Opus 5 Claude-Session: https://claude.ai/code/session_01D47qPfEWVPmhguWgBZCi5N --- ...li-package-publish-help-local-dev-example.md | 17 +++++++++++++++++ packages/cli/src/commands/package/publish.ts | 2 +- 2 files changed, 18 insertions(+), 1 deletion(-) create mode 100644 .changeset/cli-package-publish-help-local-dev-example.md diff --git a/.changeset/cli-package-publish-help-local-dev-example.md b/.changeset/cli-package-publish-help-local-dev-example.md new file mode 100644 index 0000000000..6d22c35109 --- /dev/null +++ b/.changeset/cli-package-publish-help-local-dev-example.md @@ -0,0 +1,17 @@ +--- +"@objectstack/cli": patch +--- + +`os package publish --help` no longer points its local-dev example at a directory this repo does not have. + +The last line of the command's `EXAMPLES` block read: + +``` +$ OS_CLOUD_URL=http://localhost:4000 os package publish # local dev (apps/cloud) +``` + +`apps/cloud` was deleted from this repository — the reference cloud host now lives in `objectstack-ai/cloud` — so the parenthetical sent a reader to a path that is not in the tree they cloned. This is help text, not a source comment: it is printed verbatim to anyone who runs the command. + +The parenthetical is dropped rather than re-pointed at the other repo. The example is about `OS_CLOUD_URL` overriding the control-plane URL, which the `--server` flag already documents in the same output; which directory happens to serve `localhost:4000` was never part of what the example teaches, and a `--help` reader is not looking for a file in a monorepo. `# local dev` alone carries it, and it now matches how the CLI reference docs have long published the same example. + +No behaviour changes: `examples` is a static help string, and no flag, argument, default or exit code moves. diff --git a/packages/cli/src/commands/package/publish.ts b/packages/cli/src/commands/package/publish.ts index c171e26f41..172145c1c5 100644 --- a/packages/cli/src/commands/package/publish.ts +++ b/packages/cli/src/commands/package/publish.ts @@ -165,7 +165,7 @@ export default class PackagePublish extends Command { '$ os package publish --manifest-id com.acme.crm --version 1.2.0', '$ os package publish --env env_abc123 --install', '$ os package publish dist/objectstack.json --visibility org --note "first cut"', - '$ OS_CLOUD_URL=http://localhost:4000 os package publish # local dev (apps/cloud)', + '$ OS_CLOUD_URL=http://localhost:4000 os package publish # local dev', ]; static override args = {