feat(publish): unscoped relayflows CLI package

Merged
KH
2mo ago
+334-40

Summary

  • Adds packages/relayflows, a thin CLI wrapper (relayflows on npm, flows bin) that forwards to @relayflows/sdk's real CLI by filesystem path โ€” makes npm install -g relayflows the install command instead of the scoped @relayflows/sdk.
  • Wires the new package into publish.yml: built and smoke-tested (flows check) against the packed SDK tarball, packed, and published last in the dependency-ordered publish step.
  • Updates scripts/version-packages.mjs and scripts/pack-release.mjs to handle the package's unscoped name, plus test coverage in scripts/publish.test.mjs.
  • Resolves a README.md merge conflict (Cloud review swarm section vs. the Get Started/npm install -g relayflows section) left by a background sync of main.

The relayflows package name has already been claimed on npm via a manual first publish (relayflows@2.0.1, matching the current @relayflows/sdk@2.0.1); trusted-publisher OIDC config for future automated publishes still needs to be added on npmjs.com for this new package, same as the existing @relayflows/* packages.

Test plan

  • node --test scripts/publish.test.mjs (6/6 pass, including new unscoped-name pack assertions)
  • node scripts/pack-release.mjs relayflows against the real repo state (produces relayflows-2.0.1.tgz)
  • Manually verified packages/relayflows/bin/flows.js forwards to a real @relayflows/sdk install and runs flows check correctly
  • publish.yml dry-run on this branch (workflow_dispatch, dry_run=true) to confirm the new build/pack/publish steps succeed in CI

๐Ÿค– Generated with Claude Code

https://claude.ai/code/session_01Dhjfz8SqjdpjFrWnYagtHv


Summary by cubic

Adds an unscoped relayflows package so npm install -g relayflows installs the flows CLI instead of @relayflows/sdk.

  • The package is a thin wrapper that forwards argv and stdio to the SDK's real CLI by filesystem path, since the SDK's exports doesn't expose that subpath.
  • Wires the package into publish.yml: built against the packed SDK tarball, smoke-tested with flows check, and published last in the dependency-ordered step.
  • Updates version-packages.mjs and pack-release.mjs to handle the unscoped name, with test coverage in publish.test.mjs.
  • Resolves a README merge conflict that kept the Cloud review swarm section alongside a new Get Started section.
  • The relayflows name is already claimed on npm (relayflows@2.0.1); trusted-publisher OIDC config still needs to be added on npmjs.com for automated publishes.