@savvy-web/changesets

Caution

This package is deprecated and no longer maintained. Its changelog formatter and markdown pipeline now ship in @savvy-web/silk, driven by the savvy CLI (savvy changeset replaces savvy-changesets). Sources live in the Silk Suite monorepo. No further releases, fixes, or security patches will be published here.

Custom changelog formatter and markdown processing pipeline for the Silk Suite. Replaces the default @changesets/cli/changelog formatter with a three-layer architecture: pre-validation (remark-lint), changelog formatting (Changesets API), and post-processing (remark-transform).

Features

• Section-aware changesets -- Categorize changes with h2/h3 headings (Features, Bug Fixes, Breaking Changes, etc.)
• CLI tooling -- savvy-changesets binary with init, lint, check, validate-file, transform, and version subcommands
• GitHub integration -- Automatic PR links, commit references, and contributor attribution
• Editor support -- markdownlint rules for real-time validation in VS Code and CI
• Claude Code plugin -- Automated validation and push-guard hooks, skills, and a changeset-manager agent for AI-assisted development

Repository Structure

This is a pnpm workspace monorepo:

Directory	Purpose
package/	The published @savvy-web/changesets npm package
plugin/	Companion Claude Code plugin (hooks, skills, agents)
docs/	Repository-level documentation
lib/	Shared workspace configuration (lint-staged, markdownlint)

Development

pnpm install
pnpm run build          # Build all (dev + prod)
pnpm run test           # Run all tests
pnpm run lint           # Check code with Biome
pnpm run typecheck      # Type-check via Turbo (tsgo)

See CONTRIBUTING.md for full development setup and conventions.

Documentation

• Package README -- Installation, quick start, and API overview
• CLI Reference -- All commands and options
• Section-Aware Pipeline -- End-to-end walkthrough
• Configuration -- Options, version files, CI integration
• Architecture -- Three-layer pipeline design
• API Reference -- Classes, types, Effect services, remark plugins
• Markdownlint Rules -- Per-rule documentation

License

MIT