Skip to content

RELEASE_NOTES.md

Latest commit

 

History

History
117 lines (81 loc) · 6.85 KB

RELEASE_NOTES.md

File metadata and controls

117 lines (81 loc) · 6.85 KB

Release Notes

All notable user-visible changes to MARR are documented here. The format follows Keep a Changelog conventions, grouping entries as Added / Changed / Fixed / Removed / Security per the project's version-control standard.

This file is the canonical, in-repo history. Each section is mirrored in a corresponding GitHub Release.

v3.6.0 — 2026-05-10

Added

  • marr update --project — refresh canonical standards into a previously-installed project. Hash manifest at .claude/marr/.marr-version.json distinguishes locally-edited files (prompted) from canonical advancement (silent refresh). Flags: --check (drift report, non-zero exit), --prune (remove orphans), --dry-run, --force. marr init --project now writes the manifest so first-time installs are tracked. (closes #111, partially addresses #86)
  • Mandate release notes and GitHub Release for every tagged release (#112, closes #89)

Fixed

  • marr init --project now writes the correct import line when the project uses ./.claude/CLAUDE.md instead of ./CLAUDE.md. Previously the hardcoded @.claude/marr/MARR-PROJECT-CLAUDE.md form was written into both locations, silently failing to resolve from the dotclaude location. clean, validate, doctor, and conflict detection are now location-aware (closes #106).

Security

  • Override brace-expansion to fix transitive ReDoS (#110)
  • Bump yaml from 2.8.1 to 2.8.3 (#104)
  • Bump picomatch from 4.0.3 to 4.0.4 (#103)
  • Bump flatted from 3.3.3 to 3.4.2 (#102)
  • Bump minimatch from 3.1.2 to 3.1.5 (#101)

v3.5.0 — 2026-01-10

Added

  • User config standard (#97, tracks #23)
  • Plan execution standard (#98, tracks #95)
  • STOP-GATE pattern for branch verification in the workflow standard (#99, tracks #93)

Changed

  • Adopt npm version for the release workflow (#100, tracks #90)
  • Improve marr validate error messages with better context (#32)

v3.1.0 — 2025-12-13

BREAKING: the workflow standard was split into two separate standards. Projects referencing the old combined name MUST update to the new split filenames.

Changed

  • BREAKING: Split workflow standard into prj-development-workflow-standard.md and prj-version-control-standard.md (#87)

v3.0.0 — 2025-12-08

BREAKING: helper scripts were removed in favor of GitHub CLI extensions. Workflows depending on the bundled helpers MUST migrate to gh extensions.

Added

  • marr sync command to propagate standards between projects (#61)
  • Diátaxis framework guidance in the documentation standard (#62, tracks #52)
  • Comprehensive Jekyll-compatible documentation site (#66, #68)
  • Docs link in MARR-PROJECT-CLAUDE.md template (#76)

Changed

  • Workflow standard strengthened to prevent main-branch changes (#60)
  • Documentation standard refactored for coherence and self-compliance (#64)
  • Public-release readiness pass (#72)

Fixed

  • README reflects the actual standards directory structure (#59)

Removed

  • BREAKING: Helper scripts in favor of gh extensions (#70)

v2.2.0 — 2025-12-06

Added

  • marr standard sync command (#54)
  • Conflict detection and marr doctor command (#56)
  • Structured frontmatter and CLI commands for standards (#51)

Changed

  • Updated MARR templates with improved configuration patterns (#48)

v2.1.0 — 2025-12-02

Added

  • New project standards available via marr init (#46)

Changed

  • Restructured MARR directory layout with standards/ subfolder (#33)
  • Project-level CLAUDE.md template refinements (#34)
  • MARR-USER-CLAUDE.md moved to a template file for cleaner installs (#40)

Fixed

  • CLI issues across the developer experience surface (#25, bundles #18–#22)

v2.0.0 — 2025-11-28

First public npm release as @virtualian/marr.

Added

  • npm package distribution (#1)
  • marr init --user and marr init --project CLI surface (#17)
  • Two-layer configuration: ~/.claude/marr/ user-level + ./.claude/marr/ project-level (#16)
  • Project standards system (workflow, documentation, version control, MCP, testing) (#7)
  • Role-first documentation organisation (#5)

Changed

  • Project rebranded from repo-setup to marr (#9)