OpenParable
Skip to content
← Back to skills

Upgrade Emitter Version

Development
upgrade-emitter-version

Upgrade Emitter Version is an Agent Skill for development published in the Azure/azure-sdk-for-go repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when upgrading Go emitter package and TypeSpec packages in eng/emitter-package.json to their latest versions.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/Azure/azure-sdk-for-go/blob/HEAD/.github/skills/upgrade-emitter-version/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/upgrade-emitter-version, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

Upgrade Emitter and TypeSpec Versions

Upgrade packages in eng/emitter-package.json to their latest versions.

Prerequisites

  • Node.js LTS installed
  • npm-check-updates installed globally (npm install -g npm-check-updates)
  • tsp-client installed globally (npm install -g @azure-tools/typespec-client-generator-cli)

Steps

Step 1: Change to the eng directory

Change the working directory to the eng/ folder at the repository root.

Step 2: Rename emitter-package.json to package.json

Rename emitter-package.json to package.json so that ncu can process it.

Step 3: Run ncu to upgrade packages

Run ncu -u to upgrade all packages in package.json to their latest versions.

Step 4: Ensure versions are absolute

Verify that all versions in package.json are absolute (no ~ or ^ prefixes). If any version has a ~ or ^ prefix, remove the prefix so only the version number remains.

Step 5: Rename package.json back to emitter-package.json

Rename package.json back to emitter-package.json.

Step 6: Generate the lock file

Run tsp-client generate-lock-file to update emitter-package-lock.json.

Step 7: Commit the changes

Commit both emitter-package.json and emitter-package-lock.json. Do not commit node_modules or package.json.