@savvy-web/changesets 0.1.2 → 0.2.0

package/README.md

@@ -12,6 +12,7 @@ Custom changelog formatter and markdown processing pipeline for the Silk Suite.
 - **13 section categories** -- Consistent categorization with priority-based ordering across all layers
 - **CLI tooling** -- `savvy-changesets` binary with init, lint, transform, check, and version subcommands for CI and local use
 - **GitHub integration** -- Automatic PR links, commit references, and contributor attribution
+- **Version file syncing** -- Bump version fields in additional JSON files (beyond `package.json`) using glob patterns and JSONPath expressions
 - **Remark plugins** -- Lint rules and transform plugins via `@savvy-web/changesets/remark`
 - **markdownlint rules** -- Custom rules compatible with [markdownlint-cli2](https://www.npmjs.com/package/markdownlint-cli2) and the VS Code extension via `@savvy-web/changesets/markdownlint`
 
@@ -57,6 +58,24 @@ Added a new authentication system with OAuth2 support.
 - Updated integration test fixtures
 ```
 
+## Version File Syncing
+
+If your project has JSON files beyond `package.json` that contain version fields (e.g., `plugin.json`, `marketplace.json`), add `versionFiles` to your changelog options to keep them in sync during `changeset version`:
+
+```json
+{
+  "changelog": ["@savvy-web/changesets/changelog", {
+    "repo": "owner/repo",
+    "versionFiles": [
+      { "glob": "plugin.json" },
+      { "glob": ".claude-plugin/marketplace.json", "paths": ["$.metadata.version", "$.plugins[*].version"] }
+    ]
+  }]
+}
+```
+
+When `paths` is omitted it defaults to `["$.version"]`. In monorepos, each matched file inherits the version from its nearest workspace package. See [Configuration -- versionFiles](./docs/configuration.md#versionfiles-optional) for full details including supported JSONPath syntax.
+
 ## markdownlint Integration
 
 Register the custom rules in your base config (e.g., `lib/configs/.markdownlint-cli2.jsonc`):

package/cjs/changelog.cjs

@@ -163,6 +163,7 @@ var __webpack_modules__ = {
                 return `Configuration error (${this.field}): ${this.reason}`;
             }
         }
+        effect__rspack_import_0.Data.TaggedError("VersionFileError");
     },
     "./src/schemas/github.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
@@ -209,6 +210,7 @@ var __webpack_modules__ = {
         });
         var effect__rspack_import_0 = __webpack_require__("effect");
         var _errors_js__rspack_import_1 = __webpack_require__("./src/errors.ts");
+        var _version_files_js__rspack_import_2 = __webpack_require__("./src/schemas/version-files.ts");
         const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
         const RepoSchema = effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.pattern(REPO_PATTERN, {
             message: ()=>'Repository must be in format "owner/repository" (e.g., "microsoft/vscode")'
@@ -218,7 +220,8 @@ var __webpack_modules__ = {
             commitLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
             prLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
             issueLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
-            issuePrefixes: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(effect__rspack_import_0.Schema.String))
+            issuePrefixes: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(effect__rspack_import_0.Schema.String)),
+            versionFiles: effect__rspack_import_0.Schema.optional(_version_files_js__rspack_import_2.Hh)
         });
         function validateChangesetOptions(input) {
             if (null == input) return effect__rspack_import_0.Effect.fail(new _errors_js__rspack_import_1.j1({
@@ -252,6 +255,20 @@ var __webpack_modules__ = {
         effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.minLength(1));
         const PositiveInteger = effect__rspack_import_0.Schema.Number.pipe(effect__rspack_import_0.Schema.int(), effect__rspack_import_0.Schema.positive());
     },
+    "./src/schemas/version-files.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            Hh: ()=>VersionFilesSchema
+        });
+        var effect__rspack_import_0 = __webpack_require__("effect");
+        const JsonPathSchema = effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.pattern(/^\$\.[^.]/, {
+            message: ()=>'JSONPath must start with "$." followed by a property (e.g., "$.version", "$.metadata.version")'
+        }));
+        const VersionFileConfigSchema = effect__rspack_import_0.Schema.Struct({
+            glob: effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.minLength(1)),
+            paths: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(JsonPathSchema))
+        });
+        const VersionFilesSchema = effect__rspack_import_0.Schema.Array(VersionFileConfigSchema);
+    },
     "./src/services/github.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
             Xx: ()=>GitHubService,

package/cjs/index.cjs

@@ -421,7 +421,9 @@ var __webpack_modules__ = {
             TZ: ()=>GitHubApiErrorBase,
             W4: ()=>ConfigurationErrorBase,
             hL: ()=>ChangesetValidationErrorBase,
+            iS: ()=>VersionFileErrorBase,
             j1: ()=>ConfigurationError,
+            j9: ()=>VersionFileError,
             ww: ()=>MarkdownParseErrorBase,
             zy: ()=>MarkdownParseError
         });
@@ -461,6 +463,13 @@ var __webpack_modules__ = {
                 return `Configuration error (${this.field}): ${this.reason}`;
             }
         }
+        const VersionFileErrorBase = effect__rspack_import_0.Data.TaggedError("VersionFileError");
+        class VersionFileError extends VersionFileErrorBase {
+            get message() {
+                const path = this.jsonPath ? ` at ${this.jsonPath}` : "";
+                return `Version file error (${this.filePath}${path}): ${this.reason}`;
+            }
+        }
     },
     "./src/schemas/github.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
@@ -512,6 +521,7 @@ var __webpack_modules__ = {
         });
         var effect__rspack_import_0 = __webpack_require__("effect");
         var _errors_js__rspack_import_1 = __webpack_require__("./src/errors.ts");
+        var _version_files_js__rspack_import_2 = __webpack_require__("./src/schemas/version-files.ts");
         const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
         const RepoSchema = effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.pattern(REPO_PATTERN, {
             message: ()=>'Repository must be in format "owner/repository" (e.g., "microsoft/vscode")'
@@ -521,7 +531,8 @@ var __webpack_modules__ = {
             commitLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
             prLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
             issueLinks: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Boolean),
-            issuePrefixes: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(effect__rspack_import_0.Schema.String))
+            issuePrefixes: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(effect__rspack_import_0.Schema.String)),
+            versionFiles: effect__rspack_import_0.Schema.optional(_version_files_js__rspack_import_2.Hh)
         });
         function validateChangesetOptions(input) {
             if (null == input) return effect__rspack_import_0.Effect.fail(new _errors_js__rspack_import_1.j1({
@@ -556,6 +567,22 @@ var __webpack_modules__ = {
         const NonEmptyString = effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.minLength(1));
         const PositiveInteger = effect__rspack_import_0.Schema.Number.pipe(effect__rspack_import_0.Schema.int(), effect__rspack_import_0.Schema.positive());
     },
+    "./src/schemas/version-files.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
+        __webpack_require__.d(__webpack_exports__, {
+            Hh: ()=>VersionFilesSchema,
+            hH: ()=>JsonPathSchema,
+            mC: ()=>VersionFileConfigSchema
+        });
+        var effect__rspack_import_0 = __webpack_require__("effect");
+        const JsonPathSchema = effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.pattern(/^\$\.[^.]/, {
+            message: ()=>'JSONPath must start with "$." followed by a property (e.g., "$.version", "$.metadata.version")'
+        }));
+        const VersionFileConfigSchema = effect__rspack_import_0.Schema.Struct({
+            glob: effect__rspack_import_0.Schema.String.pipe(effect__rspack_import_0.Schema.minLength(1)),
+            paths: effect__rspack_import_0.Schema.optional(effect__rspack_import_0.Schema.Array(JsonPathSchema))
+        });
+        const VersionFilesSchema = effect__rspack_import_0.Schema.Array(VersionFileConfigSchema);
+    },
     "./src/services/github.ts" (__unused_rspack_module, __webpack_exports__, __webpack_require__) {
         __webpack_require__.d(__webpack_exports__, {
             Xx: ()=>GitHubService,
@@ -714,27 +741,32 @@ var __webpack_exports__ = {};
     __webpack_require__.r(__webpack_exports__);
     __webpack_require__.d(__webpack_exports__, {
         IssueNumberSchema: ()=>schemas_github.OD,
+        VersionFilesSchema: ()=>version_files.Hh,
         ChangelogServiceBase: ()=>ChangelogServiceBase,
         UrlOrMarkdownLinkSchema: ()=>schemas_github.hY,
         GitHubInfoSchema: ()=>schemas_github.lo,
         GitHubServiceBase: ()=>github.wP,
         GitHubApiErrorBase: ()=>errors.TZ,
+        VersionFileError: ()=>errors.j9,
         ChangesetLinter: ()=>ChangesetLinter,
-        MarkdownServiceBase: ()=>markdown.M4,
         ChangesetSchema: ()=>ChangesetSchema,
+        MarkdownServiceBase: ()=>markdown.M4,
         UsernameSchema: ()=>schemas_github.Qo,
         ChangesetOptionsSchema: ()=>schemas_options.YL,
         DependencyUpdateSchema: ()=>DependencyUpdateSchema,
+        VersionFileErrorBase: ()=>errors.iS,
         VersionTypeSchema: ()=>VersionTypeSchema,
         makeGitHubTest: ()=>github.e_,
         ChangelogService: ()=>ChangelogService,
         ChangesetSummarySchema: ()=>ChangesetSummarySchema,
+        JsonPathSchema: ()=>version_files.hH,
         MarkdownParseError: ()=>errors.zy,
-        PositiveInteger: ()=>primitives.e,
         CommitHashSchema: ()=>CommitHashSchema,
         ChangelogTransformer: ()=>ChangelogTransformer,
+        PositiveInteger: ()=>primitives.e,
         NonEmptyString: ()=>primitives.u,
         ConfigurationError: ()=>errors.j1,
+        VersionFileConfigSchema: ()=>version_files.mC,
         Categories: ()=>Categories,
         Changelog: ()=>Changelog,
         SectionCategorySchema: ()=>SectionCategorySchema,
@@ -1208,6 +1240,7 @@ var __webpack_exports__ = {};
     });
     var schemas_github = __webpack_require__("./src/schemas/github.ts");
     var schemas_options = __webpack_require__("./src/schemas/options.ts");
+    var version_files = __webpack_require__("./src/schemas/version-files.ts");
 })();
 exports.Categories = __webpack_exports__.Categories;
 exports.Changelog = __webpack_exports__.Changelog;
@@ -1232,6 +1265,7 @@ exports.GitHubLive = __webpack_exports__.GitHubLive;
 exports.GitHubService = __webpack_exports__.GitHubService;
 exports.GitHubServiceBase = __webpack_exports__.GitHubServiceBase;
 exports.IssueNumberSchema = __webpack_exports__.IssueNumberSchema;
+exports.JsonPathSchema = __webpack_exports__.JsonPathSchema;
 exports.MarkdownLive = __webpack_exports__.MarkdownLive;
 exports.MarkdownParseError = __webpack_exports__.MarkdownParseError;
 exports.MarkdownParseErrorBase = __webpack_exports__.MarkdownParseErrorBase;
@@ -1243,6 +1277,10 @@ exports.RepoSchema = __webpack_exports__.RepoSchema;
 exports.SectionCategorySchema = __webpack_exports__.SectionCategorySchema;
 exports.UrlOrMarkdownLinkSchema = __webpack_exports__.UrlOrMarkdownLinkSchema;
 exports.UsernameSchema = __webpack_exports__.UsernameSchema;
+exports.VersionFileConfigSchema = __webpack_exports__.VersionFileConfigSchema;
+exports.VersionFileError = __webpack_exports__.VersionFileError;
+exports.VersionFileErrorBase = __webpack_exports__.VersionFileErrorBase;
+exports.VersionFilesSchema = __webpack_exports__.VersionFilesSchema;
 exports.VersionTypeSchema = __webpack_exports__.VersionTypeSchema;
 exports.makeGitHubTest = __webpack_exports__.makeGitHubTest;
 for(var __rspack_i in __webpack_exports__)if (-1 === [
@@ -1269,6 +1307,7 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "GitHubService",
     "GitHubServiceBase",
     "IssueNumberSchema",
+    "JsonPathSchema",
     "MarkdownLive",
     "MarkdownParseError",
     "MarkdownParseErrorBase",
@@ -1280,6 +1319,10 @@ for(var __rspack_i in __webpack_exports__)if (-1 === [
     "SectionCategorySchema",
     "UrlOrMarkdownLinkSchema",
     "UsernameSchema",
+    "VersionFileConfigSchema",
+    "VersionFileError",
+    "VersionFileErrorBase",
+    "VersionFilesSchema",
     "VersionTypeSchema",
     "makeGitHubTest"
 ].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];

package/cjs/index.d.cts

@@ -330,6 +330,11 @@ export declare const ChangesetOptionsSchema: Schema.Struct<{
     issueLinks: Schema.optional<typeof Schema.Boolean>;
     /** Custom issue reference prefixes (e.g., `["#", "GH-"]`). */
     issuePrefixes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    /** Additional JSON files to update with version numbers. */
+    versionFiles: Schema.optional<Schema.Array$<Schema.Struct<{
+        glob: Schema.filter<typeof Schema.String>;
+        paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+    }>>>;
 }>;
 
 /**
@@ -602,6 +607,14 @@ export declare interface GitHubServiceShape {
  */
 export declare const IssueNumberSchema: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
 
+/**
+ * Schema for a JSONPath expression starting with `$.`.
+ *
+ * Supports property access (`$.foo.bar`), array wildcard (`$.foo[*].bar`),
+ * and array index access (`$.foo[0].bar`).
+ */
+export declare const JsonPathSchema: Schema.filter<typeof Schema.String>;
+
 /**
  * Class-based API wrapper for changeset linting.
  *
@@ -778,6 +791,65 @@ export declare const UrlOrMarkdownLinkSchema: Schema.filter<typeof Schema.String
  */
 export declare const UsernameSchema: Schema.filter<typeof Schema.String>;
 
+/**
+ * Inferred type for {@link VersionFileConfigSchema}.
+ */
+export declare interface VersionFileConfig extends Schema.Schema.Type<typeof VersionFileConfigSchema> {
+}
+
+/**
+ * Schema for a single version file configuration entry.
+ */
+export declare const VersionFileConfigSchema: Schema.Struct<{
+    /** Glob pattern to match JSON files. */
+    glob: Schema.filter<typeof Schema.String>;
+    /** JSONPath expressions to locate version fields. Defaults to `["$.version"]`. */
+    paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+}>;
+
+/**
+ * Version file update failure.
+ *
+ * Raised when a JSON file targeted by the `versionFiles` config cannot
+ * be read, parsed, or updated at the specified JSONPath.
+ *
+ * @public
+ */
+export declare class VersionFileError extends VersionFileErrorBase<{
+    /** Absolute path to the file that failed. */
+    readonly filePath: string;
+    /** JSONPath expression that failed, if applicable. */
+    readonly jsonPath?: string | undefined;
+    /** Human-readable failure reason. */
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+
+/**
+ * Base class for VersionFileError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const VersionFileErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "VersionFileError";
+} & Readonly<A>;
+
+/**
+ * Schema for the `versionFiles` array.
+ */
+export declare const VersionFilesSchema: Schema.Array$<Schema.Struct<{
+    /** Glob pattern to match JSON files. */
+    glob: Schema.filter<typeof Schema.String>;
+    /** JSONPath expressions to locate version fields. Defaults to `["$.version"]`. */
+    paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+}>>;
+
 /**
  * Inferred type for {@link VersionTypeSchema}.
  *

package/esm/160.js

@@ -1,42 +1,7 @@
 import { getInfo } from "@changesets/get-github-info";
-import { Layer, unified, Schema, remark_stringify, Data, Effect, remark_gfm, remark_parse, Context } from "./245.js";
+import { Layer, unified, Schema, remark_stringify, Effect, GitHubApiError, VersionFilesSchema, remark_gfm, ConfigurationError, Context, remark_parse } from "./795.js";
 import { external_mdast_util_to_string_toString } from "./689.js";
 import { resolveCommitType, fromHeading } from "./60.js";
-const ChangesetValidationErrorBase = Data.TaggedError("ChangesetValidationError");
-class ChangesetValidationError extends ChangesetValidationErrorBase {
-    get message() {
-        const prefix = this.file ? `${this.file}: ` : "";
-        const detail = this.issues.map((i)=>`  - ${i.path}: ${i.message}`).join("\n");
-        return `${prefix}Changeset validation failed:\n${detail}`;
-    }
-}
-const GitHubApiErrorBase = Data.TaggedError("GitHubApiError");
-class GitHubApiError extends GitHubApiErrorBase {
-    get message() {
-        const status = this.statusCode ? ` (${this.statusCode})` : "";
-        return `GitHub API error during ${this.operation}${status}: ${this.reason}`;
-    }
-    get isRateLimited() {
-        return 403 === this.statusCode || 429 === this.statusCode;
-    }
-    get isRetryable() {
-        return void 0 !== this.statusCode && (this.statusCode >= 500 || this.isRateLimited);
-    }
-}
-const MarkdownParseErrorBase = Data.TaggedError("MarkdownParseError");
-class MarkdownParseError extends MarkdownParseErrorBase {
-    get message() {
-        const loc = this.line ? `:${this.line}${this.column ? `:${this.column}` : ""}` : "";
-        const src = this.source ? `${this.source}${loc}: ` : "";
-        return `${src}Markdown parse error: ${this.reason}`;
-    }
-}
-const ConfigurationErrorBase = Data.TaggedError("ConfigurationError");
-class ConfigurationError extends ConfigurationErrorBase {
-    get message() {
-        return `Configuration error (${this.field}): ${this.reason}`;
-    }
-}
 const REPO_PATTERN = /^[a-zA-Z0-9._-]+\/[a-zA-Z0-9._-]+$/;
 const RepoSchema = Schema.String.pipe(Schema.pattern(REPO_PATTERN, {
     message: ()=>'Repository must be in format "owner/repository" (e.g., "microsoft/vscode")'
@@ -46,7 +11,8 @@ const ChangesetOptionsSchema = Schema.Struct({
     commitLinks: Schema.optional(Schema.Boolean),
     prLinks: Schema.optional(Schema.Boolean),
     issueLinks: Schema.optional(Schema.Boolean),
-    issuePrefixes: Schema.optional(Schema.Array(Schema.String))
+    issuePrefixes: Schema.optional(Schema.Array(Schema.String)),
+    versionFiles: Schema.optional(VersionFilesSchema)
 });
 function validateChangesetOptions(input) {
     if (null == input) return Effect.fail(new ConfigurationError({
@@ -402,4 +368,4 @@ const changelogFunctions = {
 };
 const changelog = changelogFunctions;
 export default changelog;
-export { ChangesetOptionsSchema, ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, NonEmptyString, PositiveInteger, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest };
+export { ChangesetOptionsSchema, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownService, MarkdownServiceBase, NonEmptyString, PositiveInteger, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest };

package/esm/273.js

@@ -1,6 +1,6 @@
-import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-import { unified, remark_gfm, remark_stringify, remark_parse } from "./245.js";
+import { existsSync, globSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from "node:fs";
+import { join, relative, resolve } from "node:path";
+import { unified, remark_gfm, remark_stringify, remark_parse } from "./795.js";
 import { MergeSectionsPlugin, DeduplicateItemsPlugin, IssueLinkRefsPlugin, ContentStructureRule, HeadingHierarchyRule, NormalizeFormatPlugin, ReorderSectionsPlugin, ContributorFootnotesPlugin, RequiredSectionsRule } from "./234.js";
 function stripFrontmatter(content) {
     return content.replace(/^---\n[\s\S]*?\n---\n?/, "");
@@ -38,4 +38,4 @@ class ChangelogTransformer {
         writeFileSync(filePath, result, "utf-8");
     }
 }
-export { ChangelogTransformer, ChangesetLinter, existsSync, join, mkdirSync, readFileSync, resolve, writeFileSync };
+export { ChangelogTransformer, ChangesetLinter, existsSync, globSync, join, mkdirSync, readFileSync, relative, resolve, writeFileSync };

package/esm/795.js

@@ -0,0 +1,56 @@
+import { Context, Data, Effect, Layer, Schema } from "effect";
+const ChangesetValidationErrorBase = Data.TaggedError("ChangesetValidationError");
+class ChangesetValidationError extends ChangesetValidationErrorBase {
+    get message() {
+        const prefix = this.file ? `${this.file}: ` : "";
+        const detail = this.issues.map((i)=>`  - ${i.path}: ${i.message}`).join("\n");
+        return `${prefix}Changeset validation failed:\n${detail}`;
+    }
+}
+const GitHubApiErrorBase = Data.TaggedError("GitHubApiError");
+class GitHubApiError extends GitHubApiErrorBase {
+    get message() {
+        const status = this.statusCode ? ` (${this.statusCode})` : "";
+        return `GitHub API error during ${this.operation}${status}: ${this.reason}`;
+    }
+    get isRateLimited() {
+        return 403 === this.statusCode || 429 === this.statusCode;
+    }
+    get isRetryable() {
+        return void 0 !== this.statusCode && (this.statusCode >= 500 || this.isRateLimited);
+    }
+}
+const MarkdownParseErrorBase = Data.TaggedError("MarkdownParseError");
+class MarkdownParseError extends MarkdownParseErrorBase {
+    get message() {
+        const loc = this.line ? `:${this.line}${this.column ? `:${this.column}` : ""}` : "";
+        const src = this.source ? `${this.source}${loc}: ` : "";
+        return `${src}Markdown parse error: ${this.reason}`;
+    }
+}
+const ConfigurationErrorBase = Data.TaggedError("ConfigurationError");
+class ConfigurationError extends ConfigurationErrorBase {
+    get message() {
+        return `Configuration error (${this.field}): ${this.reason}`;
+    }
+}
+const VersionFileErrorBase = Data.TaggedError("VersionFileError");
+class VersionFileError extends VersionFileErrorBase {
+    get message() {
+        const path = this.jsonPath ? ` at ${this.jsonPath}` : "";
+        return `Version file error (${this.filePath}${path}): ${this.reason}`;
+    }
+}
+const JsonPathSchema = Schema.String.pipe(Schema.pattern(/^\$\.[^.]/, {
+    message: ()=>'JSONPath must start with "$." followed by a property (e.g., "$.version", "$.metadata.version")'
+}));
+const VersionFileConfigSchema = Schema.Struct({
+    glob: Schema.String.pipe(Schema.minLength(1)),
+    paths: Schema.optional(Schema.Array(JsonPathSchema))
+});
+const VersionFilesSchema = Schema.Array(VersionFileConfigSchema);
+export { default as remark_gfm } from "remark-gfm";
+export { default as remark_parse } from "remark-parse";
+export { default as remark_stringify } from "remark-stringify";
+export { unified } from "unified";
+export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, Context, Data, Effect, GitHubApiError, GitHubApiErrorBase, JsonPathSchema, Layer, MarkdownParseError, MarkdownParseErrorBase, Schema, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFilesSchema };

package/esm/bin/savvy-changesets.js

@@ -3,8 +3,9 @@ import { Args, Command, Options } from "@effect/cli";
 import { NodeContext, NodeRuntime } from "@effect/platform-node";
 import { execSync } from "node:child_process";
 import { findProjectRoot, getWorkspaceInfos } from "workspace-tools";
-import { readFileSync, ChangelogTransformer, ChangesetLinter, existsSync, resolve, mkdirSync, writeFileSync, join } from "../273.js";
-import { Data, Effect } from "../245.js";
+import { parse } from "jsonc-parser";
+import { globSync, readFileSync, ChangelogTransformer, ChangesetLinter, resolve, existsSync, relative, mkdirSync, writeFileSync, join } from "../273.js";
+import { VersionFilesSchema, Schema, VersionFileError, Data, Effect } from "../795.js";
 const dirArg = Args.directory({
     name: "dir"
 }).pipe(Args.withDefault(".changeset"));
@@ -388,6 +389,248 @@ const transformCommand = Command.make("transform", {
     dryRun: dryRunOption,
     check: transform_checkOption
 }, ({ file, dryRun, check })=>runTransform(file, dryRun, check)).pipe(Command.withDescription("Post-process CHANGELOG.md"));
+function parseJsonPath(path) {
+    if (!path.startsWith("$.")) throw new Error(`Invalid JSONPath: must start with "$." — got "${path}"`);
+    const segments = [];
+    const raw = path.slice(2);
+    if ("" === raw) return segments;
+    const tokens = raw.match(/[^.[\]]+|\[\*\]|\[\d+\]/g);
+    if (!tokens) throw new Error(`Invalid JSONPath: could not parse "${path}"`);
+    for (const token of tokens)if ("[*]" === token) segments.push({
+        type: "wildcard"
+    });
+    else if (token.startsWith("[") && token.endsWith("]")) segments.push({
+        type: "index",
+        index: Number.parseInt(token.slice(1, -1), 10)
+    });
+    else segments.push({
+        type: "property",
+        key: token
+    });
+    return segments;
+}
+function jsonPathGet(obj, path) {
+    const segments = parseJsonPath(path);
+    let current = [
+        obj
+    ];
+    for (const segment of segments){
+        const next = [];
+        for (const node of current)if (null != node && "object" == typeof node) switch(segment.type){
+            case "property":
+                {
+                    const value = node[segment.key];
+                    if (void 0 !== value) next.push(value);
+                    break;
+                }
+            case "index":
+                if (Array.isArray(node) && segment.index < node.length) next.push(node[segment.index]);
+                break;
+            case "wildcard":
+                if (Array.isArray(node)) next.push(...node);
+                break;
+        }
+        current = next;
+    }
+    return current;
+}
+function jsonPathSet(obj, path, value) {
+    const segments = parseJsonPath(path);
+    if (0 === segments.length) return 0;
+    const lastSegment = segments[segments.length - 1];
+    const parentSegments = segments.slice(0, -1);
+    let parents = [
+        obj
+    ];
+    for (const segment of parentSegments){
+        const next = [];
+        for (const node of parents)if (null != node && "object" == typeof node) switch(segment.type){
+            case "property":
+                {
+                    const child = node[segment.key];
+                    if (void 0 !== child) next.push(child);
+                    break;
+                }
+            case "index":
+                if (Array.isArray(node) && segment.index < node.length) next.push(node[segment.index]);
+                break;
+            case "wildcard":
+                if (Array.isArray(node)) next.push(...node);
+                break;
+        }
+        parents = next;
+    }
+    let count = 0;
+    for (const parent of parents)if (null != parent && "object" == typeof parent) switch(lastSegment.type){
+        case "property":
+            if (lastSegment.key in parent) {
+                parent[lastSegment.key] = value;
+                count++;
+            }
+            break;
+        case "index":
+            if (Array.isArray(parent) && lastSegment.index < parent.length) {
+                parent[lastSegment.index] = value;
+                count++;
+            }
+            break;
+        case "wildcard":
+            if (Array.isArray(parent)) for(let i = 0; i < parent.length; i++){
+                parent[i] = value;
+                count++;
+            }
+            break;
+    }
+    return count;
+}
+class VersionFiles {
+    static readConfig(cwd) {
+        const configPath = join(cwd, ".changeset", "config.json");
+        if (!existsSync(configPath)) return;
+        let raw;
+        try {
+            raw = readFileSync(configPath, "utf-8");
+        } catch  {
+            return;
+        }
+        const config = parse(raw);
+        const changelog = config.changelog;
+        if (!Array.isArray(changelog) || changelog.length < 2) return;
+        const options = changelog[1];
+        if (!options || "object" != typeof options || !("versionFiles" in options)) return;
+        try {
+            const decoded = Schema.decodeUnknownSync(VersionFilesSchema)(options.versionFiles);
+            return decoded.length > 0 ? decoded : void 0;
+        } catch (error) {
+            console.warn(`[changesets] Invalid versionFiles configuration: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+    }
+    static discoverVersions(cwd) {
+        const resolvedCwd = resolve(cwd);
+        const results = [];
+        const seen = new Set();
+        try {
+            const workspaces = getWorkspaceInfos(resolvedCwd) ?? [];
+            for (const ws of workspaces){
+                if (seen.has(ws.path)) continue;
+                seen.add(ws.path);
+                const version = readPackageVersion(ws.path);
+                if (version) results.push({
+                    name: ws.name,
+                    path: ws.path,
+                    version
+                });
+            }
+        } catch  {}
+        if (!seen.has(resolvedCwd)) {
+            const version = readPackageVersion(resolvedCwd);
+            if (version) {
+                let rootName = "root";
+                try {
+                    const pkg = JSON.parse(readFileSync(join(resolvedCwd, "package.json"), "utf-8"));
+                    if (pkg.name) rootName = pkg.name;
+                } catch  {}
+                results.push({
+                    name: rootName,
+                    path: resolvedCwd,
+                    version
+                });
+            }
+        }
+        return results;
+    }
+    static resolveVersion(filePath, workspaces, rootVersion) {
+        const resolved = resolve(filePath);
+        let bestMatch;
+        let bestLength = 0;
+        for (const ws of workspaces){
+            const rel = relative(ws.path, resolved);
+            if (!rel.startsWith("..") && ws.path.length > bestLength) {
+                bestMatch = ws;
+                bestLength = ws.path.length;
+            }
+        }
+        return bestMatch?.version ?? rootVersion;
+    }
+    static resolveGlobs(configs, cwd) {
+        const results = [];
+        const resolvedCwd = resolve(cwd);
+        for (const config of configs){
+            const matches = globSync(config.glob, {
+                cwd: resolvedCwd,
+                exclude: (f)=>f.includes("node_modules")
+            });
+            for (const match of matches)results.push([
+                join(resolvedCwd, match),
+                config
+            ]);
+        }
+        return results;
+    }
+    static detectIndent(content) {
+        const match = content.match(/^(\s+)"/m);
+        return match?.[1] ?? "  ";
+    }
+    static updateFile(filePath, jsonPaths, version) {
+        const content = readFileSync(filePath, "utf-8");
+        const indent = VersionFiles.detectIndent(content);
+        const trailingNewline = content.endsWith("\n");
+        const obj = JSON.parse(content);
+        const previousValues = jsonPaths.flatMap((jp)=>jsonPathGet(obj, jp));
+        let totalUpdated = 0;
+        for (const jp of jsonPaths)totalUpdated += jsonPathSet(obj, jp, version);
+        if (0 === totalUpdated) return;
+        let output = JSON.stringify(obj, null, indent);
+        if (trailingNewline) output += "\n";
+        writeFileSync(filePath, output, "utf-8");
+        return {
+            filePath,
+            jsonPaths,
+            version,
+            previousValues
+        };
+    }
+    static processVersionFiles(cwd, configs, dryRun = false) {
+        const workspaces = VersionFiles.discoverVersions(cwd);
+        const rootVersion = workspaces.find((ws)=>ws.path === resolve(cwd))?.version ?? "0.0.0";
+        const resolved = VersionFiles.resolveGlobs(configs, cwd);
+        const updates = [];
+        for (const [filePath, config] of resolved){
+            const jsonPaths = config.paths ?? [
+                "$.version"
+            ];
+            const version = VersionFiles.resolveVersion(filePath, workspaces, rootVersion);
+            try {
+                if (dryRun) {
+                    const content = readFileSync(filePath, "utf-8");
+                    const obj = JSON.parse(content);
+                    const previousValues = jsonPaths.flatMap((jp)=>jsonPathGet(obj, jp));
+                    if (previousValues.length > 0) updates.push({
+                        filePath,
+                        jsonPaths,
+                        version,
+                        previousValues
+                    });
+                } else {
+                    const result = VersionFiles.updateFile(filePath, jsonPaths, version);
+                    if (result) updates.push(result);
+                }
+            } catch (error) {
+                throw new Error(`Failed to update ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        return updates;
+    }
+}
+function readPackageVersion(dir) {
+    try {
+        const pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf-8"));
+        return pkg.version;
+    } catch  {
+        return;
+    }
+}
 class Workspace {
     static detectPackageManager(cwd = process.cwd()) {
         const packageJsonPath = join(cwd, "package.json");
@@ -469,14 +712,34 @@ function runVersion(dryRun) {
             });
         }
         const changelogs = Workspace.discoverChangelogs(cwd);
-        if (0 === changelogs.length) return void (yield* Effect.log("No CHANGELOG.md files found."));
-        yield* Effect.log(`Found ${changelogs.length} CHANGELOG.md file(s)`);
-        for (const entry of changelogs){
-            yield* Effect["try"]({
-                try: ()=>ChangelogTransformer.transformFile(entry.changelogPath),
-                catch: (error)=>new Error(`Failed to transform ${entry.changelogPath}: ${error instanceof Error ? error.message : String(error)}`)
+        if (0 === changelogs.length) yield* Effect.log("No CHANGELOG.md files found.");
+        else {
+            yield* Effect.log(`Found ${changelogs.length} CHANGELOG.md file(s)`);
+            for (const entry of changelogs){
+                yield* Effect["try"]({
+                    try: ()=>ChangelogTransformer.transformFile(entry.changelogPath),
+                    catch: (error)=>new Error(`Failed to transform ${entry.changelogPath}: ${error instanceof Error ? error.message : String(error)}`)
+                });
+                yield* Effect.log(`Transformed ${entry.name} → ${entry.changelogPath}`);
+            }
+        }
+        const versionFileConfigs = VersionFiles.readConfig(cwd);
+        if (versionFileConfigs) {
+            yield* Effect.log(`Found ${versionFileConfigs.length} versionFiles config(s)`);
+            const updates = yield* Effect["try"]({
+                try: ()=>VersionFiles.processVersionFiles(cwd, versionFileConfigs, dryRun),
+                catch: (error)=>{
+                    const message = error instanceof Error ? error.message : String(error);
+                    return new VersionFileError({
+                        filePath: message.match(/Failed to update (.+?):/)?.[1] ?? cwd,
+                        reason: message
+                    });
+                }
             });
-            yield* Effect.log(`Transformed ${entry.name} → ${entry.changelogPath}`);
+            for (const update of updates){
+                const action = dryRun ? "Would update" : "Updated";
+                yield* Effect.log(`${action} ${update.filePath} → ${update.version}`);
+            }
         }
     });
 }
@@ -492,7 +755,7 @@ const rootCommand = Command.make("savvy-changesets").pipe(Command.withSubcommand
 ]));
 const cli = Command.run(rootCommand, {
     name: "savvy-changesets",
-    version: "0.1.2"
+    version: "0.2.0"
 });
 function runCli() {
     const main = Effect.suspend(()=>cli(process.argv)).pipe(Effect.provide(NodeContext.layer));

package/esm/index.d.ts

@@ -330,6 +330,11 @@ export declare const ChangesetOptionsSchema: Schema.Struct<{
     issueLinks: Schema.optional<typeof Schema.Boolean>;
     /** Custom issue reference prefixes (e.g., `["#", "GH-"]`). */
     issuePrefixes: Schema.optional<Schema.Array$<typeof Schema.String>>;
+    /** Additional JSON files to update with version numbers. */
+    versionFiles: Schema.optional<Schema.Array$<Schema.Struct<{
+        glob: Schema.filter<typeof Schema.String>;
+        paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+    }>>>;
 }>;
 
 /**
@@ -602,6 +607,14 @@ export declare interface GitHubServiceShape {
  */
 export declare const IssueNumberSchema: Schema.refine<number, Schema.filter<typeof Schema.Number>>;
 
+/**
+ * Schema for a JSONPath expression starting with `$.`.
+ *
+ * Supports property access (`$.foo.bar`), array wildcard (`$.foo[*].bar`),
+ * and array index access (`$.foo[0].bar`).
+ */
+export declare const JsonPathSchema: Schema.filter<typeof Schema.String>;
+
 /**
  * Class-based API wrapper for changeset linting.
  *
@@ -778,6 +791,65 @@ export declare const UrlOrMarkdownLinkSchema: Schema.filter<typeof Schema.String
  */
 export declare const UsernameSchema: Schema.filter<typeof Schema.String>;
 
+/**
+ * Inferred type for {@link VersionFileConfigSchema}.
+ */
+export declare interface VersionFileConfig extends Schema.Schema.Type<typeof VersionFileConfigSchema> {
+}
+
+/**
+ * Schema for a single version file configuration entry.
+ */
+export declare const VersionFileConfigSchema: Schema.Struct<{
+    /** Glob pattern to match JSON files. */
+    glob: Schema.filter<typeof Schema.String>;
+    /** JSONPath expressions to locate version fields. Defaults to `["$.version"]`. */
+    paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+}>;
+
+/**
+ * Version file update failure.
+ *
+ * Raised when a JSON file targeted by the `versionFiles` config cannot
+ * be read, parsed, or updated at the specified JSONPath.
+ *
+ * @public
+ */
+export declare class VersionFileError extends VersionFileErrorBase<{
+    /** Absolute path to the file that failed. */
+    readonly filePath: string;
+    /** JSONPath expression that failed, if applicable. */
+    readonly jsonPath?: string | undefined;
+    /** Human-readable failure reason. */
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+
+/**
+ * Base class for VersionFileError.
+ *
+ * @privateRemarks
+ * This export is required for api-extractor documentation generation.
+ * Effect's Data.TaggedError creates an anonymous base class that must be
+ * explicitly exported to avoid "forgotten export" warnings. Do not delete.
+ *
+ * @internal
+ */
+export declare const VersionFileErrorBase: new <A extends Record<string, any> = {}>(args: Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => YieldableError & {
+    readonly _tag: "VersionFileError";
+} & Readonly<A>;
+
+/**
+ * Schema for the `versionFiles` array.
+ */
+export declare const VersionFilesSchema: Schema.Array$<Schema.Struct<{
+    /** Glob pattern to match JSON files. */
+    glob: Schema.filter<typeof Schema.String>;
+    /** JSONPath expressions to locate version fields. Defaults to `["$.version"]`. */
+    paths: Schema.optional<Schema.Array$<Schema.filter<typeof Schema.String>>>;
+}>>;
+
 /**
  * Inferred type for {@link VersionTypeSchema}.
  *

package/esm/index.js

@@ -1,6 +1,6 @@
 import { BREAKING_CHANGES, PERFORMANCE, fromHeading, allHeadings, resolveCommitType, CI, TESTS, DEPENDENCIES, OTHER, CATEGORIES, FEATURES, BUG_FIXES, REVERTS, DOCUMENTATION, isValidHeading, BUILD_SYSTEM, REFACTORING, MAINTENANCE } from "./60.js";
 import { default as changelog, NonEmptyString } from "./160.js";
-import { Context, Schema } from "./245.js";
+import { Context, Schema } from "./795.js";
 class Categories {
     static BREAKING_CHANGES = BREAKING_CHANGES;
     static FEATURES = FEATURES;
@@ -71,5 +71,6 @@ const DependencyUpdateSchema = Schema.Struct({
     newVersion: Schema.String
 });
 export { ChangelogTransformer, ChangesetLinter } from "./273.js";
-export { ChangesetOptionsSchema, ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitHubApiError, GitHubApiErrorBase, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownParseError, MarkdownParseErrorBase, MarkdownService, MarkdownServiceBase, NonEmptyString, PositiveInteger, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest } from "./160.js";
+export { ChangesetOptionsSchema, GitHubInfoSchema, GitHubLive, GitHubService, GitHubServiceBase, IssueNumberSchema, MarkdownLive, MarkdownService, MarkdownServiceBase, NonEmptyString, PositiveInteger, RepoSchema, UrlOrMarkdownLinkSchema, UsernameSchema, makeGitHubTest } from "./160.js";
+export { ChangesetValidationError, ChangesetValidationErrorBase, ConfigurationError, ConfigurationErrorBase, GitHubApiError, GitHubApiErrorBase, JsonPathSchema, MarkdownParseError, MarkdownParseErrorBase, VersionFileConfigSchema, VersionFileError, VersionFileErrorBase, VersionFilesSchema } from "./795.js";
 export { Categories, Changelog, ChangelogService, ChangelogServiceBase, ChangesetSchema, ChangesetSummarySchema, CommitHashSchema, DependencyTypeSchema, DependencyUpdateSchema, SectionCategorySchema, VersionTypeSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@savvy-web/changesets",
-	"version": "0.1.2",
+	"version": "0.2.0",
 	"private": false,
 	"description": "Custom changelog formatter and markdown processing pipeline for the Silk Suite. Provides structured changeset sections, remark-based validation and transformation, and an Effect CLI.",
 	"keywords": [
@@ -57,7 +57,8 @@
 		"@effect/cli": "^0.73.2",
 		"@effect/platform": "^0.94.5",
 		"@effect/platform-node": "^0.104.1",
-		"effect": "^3.19.18",
+		"effect": "^3.19.19",
+		"jsonc-parser": "^3.3.1",
 		"mdast-util-heading-range": "^4.0.0",
 		"mdast-util-to-string": "^4.0.0",
 		"remark-gfm": "^4.0.1",

package/esm/245.js

@@ -1,5 +0,0 @@
-export { Context, Data, Effect, Layer, Schema } from "effect";
-export { default as remark_gfm } from "remark-gfm";
-export { default as remark_parse } from "remark-parse";
-export { default as remark_stringify } from "remark-stringify";
-export { unified } from "unified";