| name | bump-required-versions |
| description | Bump the minimum required version of the upstream dependency this SDK rests on — the `mthds` package, which provides the MTHDS protocol wire types via its `mthds/protocol` subpath. Use when the user says "bump required versions", "bump min mthds version", "raise the mthds floor", "update required versions", "set min mthds to X.Y.Z", or any variation of changing the SDK's upstream version floor.
|
Bump Required Versions
@pipelex/sdk has one upstream version floor that matters: the mthds package, which it imports the MTHDS protocol wire types from (via the mthds/protocol subpath). Because the SDK re-implements the official protocol routes using mthds/protocol types, its route shapes are pinned to a specific mthds surface — bumping the floor is how the SDK adopts a newer protocol surface.
This floor is the mthds entry in package.json (dependencies while dev-linked via a git/branch ref; a semver range once mthds is published). It is the single source of truth.
Workflow
1. Read the current value
Show the current mthds dependency from package.json:
node -p "require('./package.json').dependencies?.mthds ?? '(not yet a dependency)'"
Until the client phase lands, mthds may not be a dependency yet — in that case there is nothing to bump; tell the user and stop.
2. Confirm the target
Ask for the new version/range if the user didn't specify it. For a published mthds, the format is a semver range (">=X.Y.Z"); while dev-linked, it is a git/branch ref (e.g. github:mthds-ai/mthds-js#<branch>). Verify the new floor is not a downgrade unless the user explicitly intends one.
3. Apply the edit
Edit the mthds line in package.json. If pinning a published version, keep it a single ">=X.Y.Z" range.
4. Verify
Run make check && make test. The build (tsc) resolves mthds/protocol against the new floor, so a green run confirms the SDK still type-checks against it.
5. Report and remind
Summarise OLD → NEW, then remind the user to:
- Add a CHANGELOG.md entry describing the bump and why (e.g., a protocol surface the SDK now relies on).
- Coordinate consumer floors if downstream repos pin a minimum
@pipelex/sdk — that is the /bump-required-versions job in those repos, not here.
Do not commit or create a release — leave that to the user (or the release skill).
