framework-release

Guides version bumps and JSR publication of Altera framework packages in dependency order.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/IgorAIvanov/altera03 --skill framework-release-igoraivanov
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: framework-release
Source: https://github.com/IgorAIvanov/altera03/tree/main/skills/src/framework-release
Command: npx skills add https://github.com/IgorAIvanov/altera03 --skill framework-release-igoraivanov

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Releasing the Altera framework means bumping versions across five interdependent packages (server, client, tools, skills, create), keeping a dozen version pins in sync, and publishing to JSR in the right order — a process where a forgotten bump or wrong pin silently ships broken packages, and JSR publication is irreversible. ## Core Features & Use Cases - Version pin discipline: Explains the single source of truth (<package>/deno.jsonversion) and every pin location across create/template/deno.json, create/deno.json, tools/deno.json, Dockerfile, and docker-compose.yml, enforced by scripts/version-pins_test.ts. - Coupled release rules: Defines which packages must move together (client→skills, client→vite, server→tools, server→SQL cores) and how to choose patch vs minor before 1.0. - Publication workflow: Covers CHANGELOG.md updates, pre-publish checks (deno task check:deps, test:unit, scaffold:verify:local, deno publish --dry-run), the push-triggered Publish to JSR workflow, post-release verification, and fix-release recovery. - Use Case: You changed the public API of @altera/server and need to release: the skill walks you through bumping server and tools, updating the changelog, running dry-run publishes, and verifying the post-release scaffold check. ## Quick Start Tell the assistant which Altera package changed and what changed in it, and ask it to prepare the release following the framework-release skill.

Frequently Asked Questions about framework-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a new version of an Altera framework package to JSR?

Bump the version in the package's deno.json, update CHANGELOG.md, run deno task skills:build, check:deps, test:unit, and scaffold:verify:local, then deno publish --dry-run per changed package. Pushing to master triggers the Publish to JSR workflow automatically after green CI.

What order should Altera packages be published in?

Publish in dependency order: server, then client, then tools, then skills, then create. Tools pins server, create imports skills, and the template inside create pins everything, so a package must be published before anything that references it.

How do I choose between a patch and minor version bump before 1.0?

Before 1.0, a minor bump means something broke for consumers: a required argument, removed export, changed signature, or changed scaffold template structure. A patch covers fixes, new optional parameters, and skill text edits where consumers change nothing.

Why did my JSR publish fail even though all local checks passed?

Common causes are slow types from a newly exported module lacking explicit return types, an unrecognized SPDX license expression like "MIT AND OFL-1.1", or an undeclared dependency. Only deno publish --dry-run catches slow types; the license is validated only by the registry after push.

What happens if I forget to bump the version before pushing a fix?

The publish workflow only publishes packages whose version is not yet in the registry, so a forgotten bump is silently skipped and the registry keeps serving old content. Fix it with a new release that bumps every burned version number, even if only a pin changed.

Can I undo a bad JSR publication?

No, JSR publication is irreversible; a published version stays in the registry forever. The remedy is a fix-release with bumped versions, guided by the post-release scaffold verify step and the jsr/<package>@<version> tags the workflow creates.