versionary 0.10.0 → 0.11.0

package/README.md

@@ -49,7 +49,7 @@ release/tag.
 
 Current implementation focuses on:
 
-- strategy-based version updates (`simple`, `node`)
+- strategy-based version updates (`simple`, `node`, `rust`, `r`)
 - release planning and changelog generation
 - review-mode vs direct-mode release flow
 - built-in GitHub SCM plugin capabilities
@@ -57,6 +57,40 @@ Current implementation focuses on:
 Planned/harder areas include deeper monorepo ergonomics, broader SCM coverage,
 and stronger failure recovery around release steps.
 
+## Adding a new release strategy
+
+Versionary is set up so new language strategies can be added internally without
+changing release orchestration. A new strategy should implement the
+`VersionStrategy` contract in `src/domain/strategy/types.ts` and be wired in
+`src/domain/strategy/resolve.ts`.
+
+Checklist for new strategies (for example `python`):
+
+- define strategy `name`
+- define `getVersionFile(config)` defaults and config override behavior
+- implement `readVersion(cwd, config)` with explicit malformed-file errors
+- implement `writeVersion(cwd, config, version)` returning deterministic updated
+  file paths
+- add release-name extraction support if package tags should derive from
+  language metadata (similar to Node/Rust/R)
+- add focused strategy tests for ecosystem-specific behavior and edge cases
+- add/extend strategy contract tests in `tests/strategy-contract.test.ts`
+- update schema/docs for new `release-type` behavior and defaults
+
+Current ecosystem policy defaults:
+
+- changelog source for publish:
+  - root target uses root `changelog-file`
+  - package target uses `packages.<path>.changelog-file` when configured, else
+    root `changelog-file`
+- lockfiles:
+  - Node strategy updates root `package-lock.json`/`npm-shrinkwrap.json` when
+    present
+  - Rust release PR prep refreshes all discovered `Cargo.lock` files
+- workspace/inheritance:
+  - Rust supports `version.workspace = true` via `[workspace.package].version`
+  - other strategies should document equivalent inheritance behavior explicitly
+
 ## Architecture layout (current migration)
 
 The repository is moving to explicit layered modules:
@@ -177,7 +211,8 @@ Release planning is based on Conventional Commit parsing semantics:
 - recognizes breaking changes from `!` and `BREAKING CHANGE` / `BREAKING-CHANGE`
   footers
 - maps release impact as `feat => minor`, `fix|perf => patch`, breaking => major
-- treats `revert:` as non-releasable commits
+- treats `revert:` commits as patch-releasable by default (and major if marked
+  breaking, e.g. `revert!:` or `BREAKING CHANGE`)
 - suppresses commits that are reverted within the analyzed release window so
   they do not affect bump/changelog output
 - emits parser diagnostics for malformed headers/footers/references and

package/dist/app/release/release.d.ts

@@ -1,4 +1,6 @@
+import type { VersionaryConfig } from "../../types/config.js";
 import type { VersionaryPluginContext } from "../../types/plugins.js";
+export declare function resolveTargetChangelogFile(config: VersionaryConfig, rootChangelogFile: string, targetPath: string): string;
 export declare function runSimpleRelease(cwd?: string): Promise<string>;
 export type SimpleRunReleaseResult = {
     action: "release-skipped";

package/dist/app/release/release.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTargetChangelogFile = resolveTargetChangelogFile;
 exports.runSimpleRelease = runSimpleRelease;
 exports.runSimpleReleaseDetailed = runSimpleReleaseDetailed;
 const node_child_process_1 = require("node:child_process");
@@ -46,6 +47,16 @@ function readReleaseNotes(cwd, version, changelogFile) {
         .trim();
     return notes.length > 0 ? notes : `Automated release for v${version}`;
 }
+function resolveTargetChangelogFile(config, rootChangelogFile, targetPath) {
+    if (targetPath === ".") {
+        return rootChangelogFile;
+    }
+    const packageChangelogFile = config.packages?.[targetPath]?.["changelog-file"];
+    if (!packageChangelogFile) {
+        return rootChangelogFile;
+    }
+    return node_path_1.default.posix.join(targetPath, packageChangelogFile);
+}
 async function runSimpleRelease(cwd = process.cwd()) {
     const result = await runSimpleReleaseDetailed(cwd, { logger: console });
     if (result.action === "release-skipped") {
@@ -99,10 +110,11 @@ async function runSimpleReleaseDetailed(cwd = process.cwd(), options = {}) {
     const createReleaseMetadata = plugin.createReleaseMetadata;
     const releases = [];
     for (const target of targets) {
+        const targetChangelogFile = resolveTargetChangelogFile(loaded.config, changelogFile, target.path);
         const outcome = await (0, recovery_js_1.executeIdempotentReleaseTarget)(cwd, {
             tag: target.tag,
             version: target.version,
-            notes: readReleaseNotes(cwd, target.version, changelogFile),
+            notes: readReleaseNotes(cwd, target.version, targetChangelogFile),
         }, {
             createReleaseMetadata: (input) => createReleaseMetadata(input, {
                 cwd,

package/dist/domain/release/changelog.js

@@ -48,6 +48,7 @@ function groupCommitLines(commits, repoUrl) {
     const breaking = [];
     const features = [];
     const fixes = [];
+    const reverts = [];
     for (const commit of commits) {
         const type = (0, commits_js_1.inferReleaseTypeFromParsedCommit)(commit);
         if (!type) {
@@ -63,6 +64,10 @@ function groupCommitLines(commits, repoUrl) {
         const line = `- ${label}${message} (${hashLabel})${referencesSuffix}`;
         const commitType = (commit.type ?? "").toLowerCase();
         const isBreaking = type === "major";
+        if (commit.isRevert) {
+            reverts.push(line);
+            continue;
+        }
         if (isBreaking) {
             breaking.push(line);
         }
@@ -76,7 +81,7 @@ function groupCommitLines(commits, repoUrl) {
             fixes.push(line);
         }
     }
-    return { breaking, features, fixes };
+    return { breaking, features, fixes, reverts };
 }
 function renderSimpleReleaseNotes(input, options = {}) {
     const repoUrl = (0, repo_url_js_1.resolveRepositoryWebBaseUrl)(input.cwd ?? process.cwd());
@@ -94,6 +99,9 @@ function renderSimpleReleaseNotes(input, options = {}) {
     if (grouped.fixes.length > 0) {
         sections.push("### Bug Fixes", ...grouped.fixes, "");
     }
+    if (grouped.reverts.length > 0) {
+        sections.push("### Reverts", ...grouped.reverts, "");
+    }
     const lines = [header, "", ...sections];
     if (options.includeFooter) {
         lines.push("\n---\n\nThis PR was generated by [Versionary](https://github.com/jolars/versionary).");
@@ -127,6 +135,9 @@ function renderPackageChangelogSection(input) {
     if (grouped.fixes.length > 0) {
         sections.push("### Bug Fixes", ...grouped.fixes, "");
     }
+    if (grouped.reverts.length > 0) {
+        sections.push("### Reverts", ...grouped.reverts, "");
+    }
     return [header, "", ...sections].join("\n");
 }
 function prependChangelog(cwd, changelogFile, section) {

package/dist/infra/git/commits.js

@@ -351,12 +351,12 @@ function getParsedCommitsForPath(cwd = process.cwd(), baselineSha, packagePath =
     return readGitLogFull(cwd, range, [normalizedPackagePath, ...excludes]);
 }
 function inferReleaseTypeFromParsedCommit(commit) {
-    if (commit.isRevert) {
-        return null;
-    }
     if (commit.isBreaking) {
         return "major";
     }
+    if (commit.isRevert) {
+        return "patch";
+    }
     const type = commit.type?.toLowerCase() ?? "";
     if (type === "feat") {
         return "minor";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "versionary",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Automatic release framework based on conventional commits and semantic versioning",
   "keywords": [
     "releasing",