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.json → version) 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.