From 1212152e3258453812c2dc9ba76ca3ad7e443341 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 31 Oct 2026 15:15:23 +0000 Subject: [PATCH 1/2] docs(skills): the os package publish row points app authors at the marketplace handbook The app-authoring agent reads `os package publish` in skills/objectstack-platform/references/operations.md and never found the page that says what a listing is made of (objectstack.manifest.json, the README), what review checks, and what the customer's administrator goes through. One link line on that row names it. Paid for under the skills token ratchet by deleting the cloud-connection blockquote's tail (the LocalManifestSource ledger and runtime-identity bind v2), which describes plugin internals an app author never acts on and whose home is the plugin's own source comments. Claude-Session: https://claude.ai/code/session_01FEkQ5p7yCAhAMSXLu1fXaZ Co-authored-by: Claude --- skills/objectstack-platform/references/operations.md | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/skills/objectstack-platform/references/operations.md b/skills/objectstack-platform/references/operations.md index 4c790c33a4f..c3bf776b4a2 100644 --- a/skills/objectstack-platform/references/operations.md +++ b/skills/objectstack-platform/references/operations.md @@ -103,7 +103,7 @@ Port resolution is the same for `os dev` and `os start` (both spawn `os serve`): | `os environments list` / `create` / `switch` | Manage cloud environments (prod/staging/dev) | | `os register` | Register the local stack as a deployable target | | `os cloud login` / `logout` / `whoami` | Cloud auth subcommands (these three only — there are no `os cloud logs/metrics/status`) | -| `os package publish [dist/objectstack.json] [--env … --install --visibility org]` | Upload the compiled artifact as a versioned package to the cloud catalog (ADR-0008 P3) | +| `os package publish [dist/objectstack.json] [--env … --install --visibility org]` | Upload the compiled artifact as a versioned package to the cloud catalog (ADR-0008 P3). Listing file, README, review and every screen the customer's administrator meets: [Marketplace handbook](https://objectstack.ai/docs/deployment/marketplace-handbook) | | `os package install [--version │ --runtime http://localhost:3000]` | Install a package into a **running** runtime via its install-local endpoint. Catalog mode (by manifest id) or air-gapped local-artifact mode. Auths with the **target runtime's** session (`--email/--password` or `OS_RUNTIME_EMAIL`/`OS_RUNTIME_PASSWORD`), not the cloud login | > **Cloud connection & marketplace (`@objectstack/cloud-connection`, ADR-0008/0009).** @@ -111,9 +111,7 @@ Port resolution is the same for `os dev` and `os start` (both spawn `os serve`): > `CloudConnectionPlugin`/`createCloudConnectionPlugin`, `MarketplaceProxyPlugin`, > `MarketplaceInstallLocalPlugin`, `RuntimeConfigPlugin` — expose the install-local > endpoint that `os package install` targets, ship the **Installed Apps** page and -> marketplace Setup nav as plugin metadata, and maintain `LocalManifestSource` -> (a local desired-state ledger) plus runtime-identity bind v2 (environment-less -> self-hosted binding). +> marketplace Setup nav as plugin metadata. ## Shipping a plugin From d9530dd0e3f70ae5434f403bf49f45bb202eb39e Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 31 Oct 2026 15:29:59 +0000 Subject: [PATCH 2/2] chore(changeset): @objectstack/skills patch for the marketplace handbook line skills/** ships inside @objectstack/skills (dist/skills via sync-catalog.mjs, and dist is in its files[]), so a skills-only change releases and owes a patch changeset; the skip-changeset label sent on the PR create was wrong and is removed in the same round. Claude-Session: https://claude.ai/code/session_01FEkQ5p7yCAhAMSXLu1fXaZ Co-authored-by: Claude --- .changeset/27331-skills-marketplace-handbook-link.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 .changeset/27331-skills-marketplace-handbook-link.md diff --git a/.changeset/27331-skills-marketplace-handbook-link.md b/.changeset/27331-skills-marketplace-handbook-link.md new file mode 100644 index 00000000000..e6b1c5d26c3 --- /dev/null +++ b/.changeset/27331-skills-marketplace-handbook-link.md @@ -0,0 +1,12 @@ +--- +'@objectstack/skills': patch +--- + +docs(skills): the `os package publish` row of objectstack-platform's operations reference points app authors at the Marketplace handbook + +Clause-②: no +Metadata-protocol: none + +- **Before.** The platform skill's operations reference described `os package publish` as an upload to the cloud catalog and nothing more. An agent authoring an app from the skills never found the page that says what a listing is made of (`objectstack.manifest.json`, the README), what review checks, and what the customer's administrator goes through after installing. +- **Now.** That row names the listing file, the README, review and the administrator's screens, and links `https://objectstack.ai/docs/deployment/marketplace-handbook`. +- Paid for under the skills token ratchet by deleting the cloud-connection note's tail (the `LocalManifestSource` ledger and runtime-identity bind v2), plugin internals an app author never acts on. The file stays under its ceiling; no ceiling moves, no frontmatter, schema, key or behaviour changes.