Skip to content

feat(cli)!: remove legacy os publish / os rollback commands - #2237

Merged
os-zhuang merged 1 commit into
mainfrom
chore/remove-legacy-publish-rollback
Jun 23, 2026
Merged

feat(cli)!: remove legacy os publish / os rollback commands#2237
os-zhuang merged 1 commit into
mainfrom
chore/remove-legacy-publish-rollback

Conversation

@baozhoutao

Copy link
Copy Markdown
Contributor

What

Removes the legacy CLI commands:

  • packages/cli/src/commands/publish.tsos publish (direct-to-environment, wrote sys_environment_revision)
  • packages/cli/src/commands/rollback.tsos rollback (switched the active revision)

Also:

  • Cleans up the now-dangling "legacy objectstack publish path" reference in the os package publish header comment.
  • Removes the unused activateRevision() helper from @objectstack/client (packages/client/src/index.ts) — it had no callers in the workspace.

Why

The legacy direct-to-environment publish flow is superseded by the versioned-package flow (os package publish, ADR-0006 v4 Phase B). oclif discovers commands by file (pattern strategy), so deleting the files removes the commands — no registry to update. src/index.ts only exported PackagePublishCommand, and the README already documents only os package publish.

Breaking change

os publish and os rollback no longer exist. Use os package publish (+ os package install).

Not included (needs a decision)

The backend route POST /api/v1/cloud/environments/:id/revisions/:commit/activate may still be implemented server-side. This PR only removes the CLI + the unused client helper. If other consumers (Console UI, direct REST) still rely on it, the endpoint should be retired separately.

Docs

Companion docs PR in objectstack-ai/objectos removes these from the CLI reference.

The legacy direct-to-environment publish flow (write sys_environment_revision via
os publish, switch revisions via os rollback) is superseded by the versioned-package
flow (os package publish). Remove both commands, the now-dangling reference in the
package publish header comment, and the unused client activateRevision() helper.
BREAKING CHANGE: os publish and os rollback are removed; use os package publish.
@vercel

vercelBot commented Jun 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJun 23, 2026 10:47am

Request Review

@github-actions

Copy link
Copy Markdown
Contributor

📓 Docs Drift Check

This PR changes 2 package(s): @objectstack/cli, @objectstack/client.

15 hand-written doc(s) reference the affected code and may need an implementation-accuracy re-verification:

  • content/docs/concepts/cloud-artifact-api.mdx(via packages/cli)
  • content/docs/concepts/implementation-status.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/concepts/packages.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/getting-started/cli.mdx(via @objectstack/cli)
  • content/docs/getting-started/quick-start.mdx(via @objectstack/cli)
  • content/docs/guides/authentication.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/guides/client-sdk.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/guides/hook-bodies.mdx(via packages/cli)
  • content/docs/guides/packages.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/guides/project-scoping.mdx(via @objectstack/cli, @objectstack/client)
  • content/docs/guides/runtime-services/data-service.mdx(via packages/cli, packages/client)
  • content/docs/guides/runtime-services/index.mdx(via packages/cli, packages/client)
  • content/docs/guides/skills.mdx(via packages/cli, packages/client)
  • content/docs/protocol/objectos/plugin-spec.mdx(via @objectstack/cli)
  • content/docs/protocol/objectos/realtime-protocol.mdx(via @objectstack/cli, @objectstack/client)

Advisory only. To re-verify, run the docs-accuracy-audit workflow scoped to these files:
node scripts/docs-audit/affected-docs.mjs origin/main → pass the list as args.docs.

@os-zhuang
os-zhuang merged commit cd58de3 into mainJun 23, 2026
16 checks passed
@os-zhuang
os-zhuang deleted the chore/remove-legacy-publish-rollback branch June 23, 2026 14:43
os-zhuang added a commit that referenced this pull request Jun 26, 2026
…search, authz, SDUI styling, dataset joins, package-first (#2338)
Audit of ~1 week of changes (298 commits, 3 breaking, 20 new ADRs) surfaced
hand-written docs that were stale or missing. All shapes verified against the
current spec/CLI.
P1 — docs were WRONG:
- os publish / os rollback removed (#2237): rewrite publish-and-preview around
`os package publish`; fix cloud-deployment, cloud-artifact-api, protocol
objectos/objectql docs, README, platform skill (migration `os rollback` is gone
too — migrate is plan/apply, forward-only).
- RLS current_user (ADR-0068): permission.mdx + core-concepts dropped the removed
singular `current_user.role` / `current_user.region`; `roles` is a string array.
- sharingModel enum (ADR-0055/0056): object.mdx adds public_read /
public_read_write / controlled_by_parent + legacy aliases.
P2 — shipped but undocumented:
- Record search (ADR-0061): data-modeling — `searchableFields` + `$search`.
- Unified authz (ADR-0066): security — `sys_capability` registry, object `access`
posture, object `requiredPermissions`.
- SDUI styling (ADR-0065): page.mdx — `responsiveStyles` (preferred channel).
- Dataset multi-hop joins (ADR-0071): analytics-datasets — dotted paths, <=3 hops,
to-one only.
- Package-first authoring (ADR-0070): metadata-lifecycle — writable-base contract.
P3:
- Built-in identity roles (ADR-0068) in security; per-env @better-auth/sso +
`features.sso` note in auth-sso (ADR-0069).
- Status-header correction on ADR-0061 / ADR-0071 (code shipped; headers lagged).
Docs-only. Build Docs CI validates MDX.
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

@baozhoutao@os-zhuang