release-v5-acp

name	release-v5-acp
description	Release @mcpc/acp-ai-provider package for AI SDK v5 (0.1.x versions) from release-v5 branch. Handles version bump, tagging, and publishing workflow.

Release ACP AI Provider for AI SDK v5

Release @mcpc/acp-ai-provider package for the AI SDK v5 compatibility line (version 0.1.x).

Version Compatibility

ACP Version	AI SDK Version	Branch
0.2.x	v6	main
0.1.x	v5	release-v5

When to Use

• Fix bugs in AI SDK v5 compatibility line
• Release new 0.1.x versions
• Backport fixes from main to release-v5

Steps

1. Switch to release-v5 Branch

git checkout release-v5
git pull origin release-v5

2. Apply Fixes (if needed)

Cherry-pick fixes from main:

git cherry-pick <commit-hash>

Or manually apply changes. Note: release-v5 uses AI SDK V2 types (LanguageModelV2StreamPart), main uses V3 (LanguageModelV3StreamPart).

3. Update Version

Edit packages/acp-ai-provider/deno.json:

{
  "version": "0.1.x" // Increment patch version
}

4. Verify Changes

deno fmt packages/acp-ai-provider/
deno check packages/acp-ai-provider/mod.ts
deno test --allow-all packages/acp-ai-provider/tests/

5. Commit

git add packages/acp-ai-provider/deno.json
git commit -m "chore(acp-ai-provider): bump version to 0.1.x"

6. Create and Push Tag

git tag v0.1.x  # Use the new version
git push origin release-v5
git push origin v0.1.x

7. Update Downstream Packages (Optional)

If core or other packages need to use the new version:

1. Update packages/core/deno.json:

   "@mcpc/acp-ai-provider": "npm:@mcpc-tech/acp-ai-provider@^0.1.x"
   

2. Bump core version (0.3.x → 0.3.x+1)

3. Sync all dependent packages to use new core version

4. Tag core: git tag v0.3.x+1

Key Differences from Main

Aspect	release-v5	main
AI SDK	V2	V3
Version	0.1.x	0.2.x
Types	LanguageModelV2StreamPart	LanguageModelV3StreamPart
ACP SDK	^0.4.8	^0.14.1

Tips

• Always test with AI SDK v5 before releasing
• Keep version commits separate from fix commits
• Use chore(acp-ai-provider): prefix for version bumps
• Tag format: v0.1.x (matches the package version)