chore(release): bump version to 1.4.0

Author: zackkatz

AGENTS.md

@@ -336,6 +336,22 @@ No build step — pure ESM JavaScript, runs directly with `node src/index.js`. R
 
 11. **`gf_list_field_types` defaults to summary mode.** Returns only `type`, `label`, `category` per field type. Pass `detail=true` for full metadata (supports, storage, validation). Pass `include_variants=true` with `detail=true` for variant data. This prevents accidentally dumping thousands of tokens for all 44 field types. — `field-operations/index.js:142-211`
 
+12. **Test mode resolves env vars at client construction.** When `GRAVITYMCP_TEST_MODE=true`, `testConfig.resolveEnv()` remaps `GRAVITY_FORMS_TEST_BASE_URL` → `GRAVITY_FORMS_BASE_URL` (and consumer key/secret). The rest of the client and AuthManager work unchanged. — `config/test-config.js:60-95`, `gravity-forms-client.js:16`
+
+## Releasing
+
+**Every version tag MUST include a CHANGELOG.md update.** Follow this checklist:
+
+1. **Update `CHANGELOG.md`** — add a new `## [X.Y.Z] - YYYY-MM-DD` section with all changes since the last release. Follow [Keep a Changelog](https://keepachangelog.com/) format (Added, Changed, Fixed, Removed).
+2. **Bump `version` in `package.json`**
+3. **Update version in `CLAUDE.md`** (Project Identity → Package line)
+4. **Add link** at bottom of `CHANGELOG.md`: `[X.Y.Z]: https://github.com/GravityKit/GravityMCP/releases/tag/vX.Y.Z`
+5. **Commit**: `git commit -m "chore(release): bump version to X.Y.Z"`
+6. **Tag**: `git tag vX.Y.Z`
+7. **Push**: `git push origin main --tags`
+
+Skipping any step (especially CHANGELOG) will leave the release history incomplete for future developers and AI agents.
+
 ## Related Resources
 
 - **CLAUDE.md** — Concise project identity and critical rules

CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to GravityMCP will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.4.0] - 2026-03-20
+
+### Added
+- Test mode environment resolution: when `GRAVITYMCP_TEST_MODE=true`, the client automatically uses `GRAVITY_FORMS_TEST_*` env vars (base URL, consumer key/secret) instead of live credentials
+- `testConfig.resolveEnv()` method in `config/test-config.js` as the canonical place for environment resolution
+- Init log now shows `(TEST MODE)` indicator when connecting to test site
+- Support for `GRAVITY_FORMS_TEST_BASE_URL` env var (in addition to existing `GRAVITY_FORMS_TEST_URL`)
+
+### Fixed
+- Removed 4 unused variable warnings (`response` in delete methods, `safeHeaders` in request interceptor)
+
+## [1.3.0] - 2026-03-10
+
+### Added
+- Compact mode: `stripEmpty()` recursively removes `null` and `""` values from all responses to reduce token usage
+- Entry meta stripping: plugin-added meta keys (e.g., `gv_revision_*`, `helpscout_conversation_id`) are stripped by default via `stripEntryMeta()`
+- Pass `compact=false` for full raw data
+
+### Fixed
+- Updated axios and MCP SDK to patch security vulnerabilities
+
+## [1.1.0] - 2026-03-10
+
+### Changed
+- Reduced token usage across all tool responses: no pretty-print, no redundant `message` strings, no echo-back of input IDs
+- Updated AGENTS.md and CLAUDE.md for token optimization documentation
+
+### Fixed
+- Granted `contents:write` permission in publish CI workflow
+
 ## [1.0.5] - 2026-02-18
 
 ### Fixed
@@ -72,6 +102,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Field filters (1 tool)
 - Results/Analytics (1 tool)
 
+[1.4.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.4.0
+[1.3.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.3.0
+[1.1.0]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.1.0
 [1.0.5]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.5
 [1.0.4]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.4
 [1.0.3]: https://github.com/GravityKit/GravityMCP/releases/tag/v1.0.3

CLAUDE.md

@@ -4,7 +4,7 @@ You MUST fully ingest @AGENTS.md first.
 
 ## Project Identity
 
-- **Package:** `@gravitykit/gravitymcp` v1.3.0
+- **Package:** `@gravitykit/gravitymcp` v1.4.0
 - **Type:** Node.js MCP server (ESM)
 - **Purpose:** Full Gravity Forms REST API v2 coverage via 28 MCP tools
 - **Repo:** https://github.com/GravityKit/GravityMCP
@@ -36,3 +36,15 @@ Required env vars (see `.env.example` for full list):
 6. **Minimize response tokens** — no pretty-print (`JSON.stringify(result)` not `null, 2`), no redundant `message` strings, no echo-back of input IDs, no `created`/`updated` booleans. Return only essential data.
 7. **Keep tool descriptions terse** — every token in tool schemas is sent on every `tools/list` call
 8. **Compact mode strips null, empty strings, and entry meta** — `stripEmpty()` in `utils/compact.js` runs on all responses. Entry tools also strip plugin-added meta keys via `stripEntryMeta()`, keeping only core properties and field values. `false` is preserved. Pass `compact=false` for full raw data.
+9. **Test mode uses dev site** — when `GRAVITYMCP_TEST_MODE=true`, the client auto-resolves `GRAVITY_FORMS_TEST_*` env vars to connect to the test site instead of production. Resolution logic lives in `testConfig.resolveEnv()` in `config/test-config.js`.
+
+## Release Checklist
+
+When tagging a new version, you MUST complete ALL of these steps:
+
+1. Update `CHANGELOG.md` with all changes since the last release (follow Keep a Changelog format)
+2. Bump `version` in `package.json`
+3. Update the version in this file (`CLAUDE.md` → Project Identity → Package)
+4. Commit with message `chore(release): bump version to X.Y.Z`
+5. Tag: `git tag vX.Y.Z`
+6. Push: `git push origin main --tags`

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravitykit/gravitymcp",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Full-featured MCP server for Gravity Forms",
   "main": "src/index.js",
   "type": "module",