@hanna84/mcp-writing 1.4.0 → 1.4.2

package/CHANGELOG.md

@@ -1,108 +1,210 @@
-# Changelog
+### Changelog
 
-## [1.4.0](https://github.com/hannasdev/mcp-writing/compare/v1.3.8...v1.4.0) (2026-04-18)
+All notable changes to this project will be documented in this file. Dates are displayed in UTC.
 
+Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
-### Features
+#### [v1.4.2](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.4.1...v1.4.2)
 
-* add runtime write-access diagnostics for onboarding ([434c453](https://github.com/hannasdev/mcp-writing/commit/434c45323b7662312cff8cc24e2c8ee2c0fd8745))
+- fix: correct node argument handling in release version guard [`#35`](https://github.com/hannasdev/mcp-writing.git
+/pull/35)
+- fix: prevent stale release reruns from republishing tags [`#34`](https://github.com/hannasdev/mcp-writing.git
+/pull/34)
 
-## [1.3.8](https://github.com/hannasdev/mcp-writing/compare/v1.3.7...v1.3.8) (2026-04-18)
+#### [v1.4.1](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.4.0...v1.4.1)
 
+> 19 April 2026
 
-### Miscellaneous Chores
+- chore: switch release workflow to deploy-key SSH auth [`#33`](https://github.com/hannasdev/mcp-writing.git
+/pull/33)
+- fix: correct release increment regex quoting on main [`#32`](https://github.com/hannasdev/mcp-writing.git
+/pull/32)
+- fix: support legacy release token secret name [`#31`](https://github.com/hannasdev/mcp-writing.git
+/pull/31)
+- chore: migrate release automation from Release Please to release-it [`#30`](https://github.com/hannasdev/mcp-writing.git
+/pull/30)
+- Release 1.4.1 [`aa88a29`](https://github.com/hannasdev/mcp-writing.git
+/commit/aa88a29899cc2b81ef2d62b2024b73fa8dddcd8e)
 
-* enable auto-merge for Release Please version PRs ([#24](https://github.com/hannasdev/mcp-writing/issues/24)) ([07981af](https://github.com/hannasdev/mcp-writing/commit/07981af84c4029cb25aef1947f301eb172df3d3a))
+#### [v1.4.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.8...v1.4.0)
 
-## [1.3.7](https://github.com/hannasdev/mcp-writing/compare/v1.3.6...v1.3.7) (2026-04-18)
+> 18 April 2026
 
+- chore(main): release 1.4.0 [`#29`](https://github.com/hannasdev/mcp-writing.git
+/pull/29)
+- docs: streamline README for first-time onboarding [`#28`](https://github.com/hannasdev/mcp-writing.git
+/pull/28)
+- docs: streamline README for first-time onboarding [`#27`](https://github.com/hannasdev/mcp-writing.git
+/pull/27)
+- docs: streamline README for first-time onboarding [`#26`](https://github.com/hannasdev/mcp-writing.git
+/pull/26)
+- feat: add runtime write-access diagnostics for onboarding [`434c453`](https://github.com/hannasdev/mcp-writing.git
+/commit/434c45323b7662312cff8cc24e2c8ee2c0fd8745)
 
-### Miscellaneous Chores
+#### [v1.3.8](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.7...v1.3.8)
 
-* **ci:** remove npm whoami diagnostic step ([65435e9](https://github.com/hannasdev/mcp-writing/commit/65435e9c8cfa829ceb6937904250c46afc45b54c))
+> 18 April 2026
 
-## [1.3.6](https://github.com/hannasdev/mcp-writing/compare/v1.3.5...v1.3.6) (2026-04-18)
+- chore(main): release 1.3.8 [`#25`](https://github.com/hannasdev/mcp-writing.git
+/pull/25)
+- chore: enable auto-merge for Release Please version PRs [`#24`](https://github.com/hannasdev/mcp-writing.git
+/pull/24)
 
+#### [v1.3.7](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.6...v1.3.7)
 
-### Bug Fixes
+> 18 April 2026
 
-* **ci:** restore npm trusted publishing auth config ([f043368](https://github.com/hannasdev/mcp-writing/commit/f0433681e984e34d1c38725f2d85dc3d14031626))
+- chore(main): release 1.3.7 [`#22`](https://github.com/hannasdev/mcp-writing.git
+/pull/22)
+- docs: add prerequisites, setup verification, and troubleshooting guide [`#23`](https://github.com/hannasdev/mcp-writing.git
+/pull/23)
+- chore(ci): remove npm whoami diagnostic step [`65435e9`](https://github.com/hannasdev/mcp-writing.git
+/commit/65435e9c8cfa829ceb6937904250c46afc45b54c)
 
-## [1.3.5](https://github.com/hannasdev/mcp-writing/compare/v1.3.4...v1.3.5) (2026-04-18)
+#### [v1.3.6](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.5...v1.3.6)
 
+> 18 April 2026
 
-### Bug Fixes
+- chore(main): release 1.3.6 [`#21`](https://github.com/hannasdev/mcp-writing.git
+/pull/21)
+- fix(ci): add npm whoami diagnostic step [`9d6b13e`](https://github.com/hannasdev/mcp-writing.git
+/commit/9d6b13e924e802df25099b42a178a772153e66c3)
+- fix: add repository url for npm provenance [`50c2d21`](https://github.com/hannasdev/mcp-writing.git
+/commit/50c2d216776cb3117e67b3ff1cc65f1192fb0955)
+- fix(ci): restore npm trusted publishing auth config [`f043368`](https://github.com/hannasdev/mcp-writing.git
+/commit/f0433681e984e34d1c38725f2d85dc3d14031626)
 
-* **ci:** force OIDC-only npm publish auth ([c9f1216](https://github.com/hannasdev/mcp-writing/commit/c9f1216f2d3aa49fcc2aad5e6c4032962ad843d1))
+#### [v1.3.5](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.4...v1.3.5)
 
-## [1.3.4](https://github.com/hannasdev/mcp-writing/compare/v1.3.3...v1.3.4) (2026-04-18)
+> 18 April 2026
 
-
-### Bug Fixes
-
-* **ci:** use tag trigger for npm publish (matches n8n pattern) ([#18](https://github.com/hannasdev/mcp-writing/issues/18)) ([a3c5992](https://github.com/hannasdev/mcp-writing/commit/a3c5992e8cb560aa79b554389d41457fcf3c0cfd))
-
-## [1.3.3](https://github.com/hannasdev/mcp-writing/compare/v1.3.2...v1.3.3) (2026-04-18)
-
-
-### Bug Fixes
-
-* **ci:** use tag trigger for npm publish (matches n8n pattern) ([6841de7](https://github.com/hannasdev/mcp-writing/commit/6841de78a90c3b4c121761d28a09b02f9d360a96))
-
-## [1.3.2](https://github.com/hannasdev/mcp-writing/compare/v1.3.1...v1.3.2) (2026-04-18)
-
-
-### Bug Fixes
-
-* **ci:** publish from main release commits for npm trusted publishing ([135ab25](https://github.com/hannasdev/mcp-writing/commit/135ab254fb91ee6427a79cdecdc5b9bf55cfb4d1))
-
-## [1.3.1](https://github.com/hannasdev/mcp-writing/compare/v1.3.0...v1.3.1) (2026-04-18)
-
-
-### Bug Fixes
-
-* **ci:** set npm environment for trusted publishing ([b75fb08](https://github.com/hannasdev/mcp-writing/commit/b75fb0897dbbbd9df2d136cbb78a06218f0c0b50))
-
-
-### Miscellaneous Chores
-
-* generate integration fixtures at runtime and remove test-sync ([#14](https://github.com/hannasdev/mcp-writing/issues/14)) ([0ff5024](https://github.com/hannasdev/mcp-writing/commit/0ff5024f0c3724b099035a6f76fbe4c517870652))
-
-## [1.3.0](https://github.com/hannasdev/mcp-writing/compare/v1.2.0...v1.3.0) (2026-04-17)
-
-
-### Features
-
-* formalize non-draft content and stable Scrivener imports ([#12](https://github.com/hannasdev/mcp-writing/issues/12)) ([70b4beb](https://github.com/hannasdev/mcp-writing/commit/70b4bebd0d3cd823ffe3a9251f59f9a0c0e5f12f))
-
-## [1.2.0](https://github.com/hannasdev/mcp-writing/compare/v1.1.1...v1.2.0) (2026-04-17)
-
-
-### Features
-
-* Phase 3 git-backed prose editing, runtime config tool, startup path logging ([f30a7c8](https://github.com/hannasdev/mcp-writing/commit/f30a7c8b5e5aaf070b0b6cfaec38479141c5f60b))
-
-## [1.1.1](https://github.com/hannasdev/mcp-writing/compare/v1.1.0...v1.1.1) (2026-04-16)
-
-
-### Bug Fixes
-
-* use dedicated token for release-please workflow ([#10](https://github.com/hannasdev/mcp-writing/issues/10)) ([6167a59](https://github.com/hannasdev/mcp-writing/commit/6167a598999c173ba04bcdc61223259449e1cf24))
-
-
-### Miscellaneous Chores
-
-* fix lint in MCP validation scripts ([2b2385e](https://github.com/hannasdev/mcp-writing/commit/2b2385e3eddd8fd30716d0f72dfa6346ec2d6e5f))
-* include chore commits in release automation ([5a28f27](https://github.com/hannasdev/mcp-writing/commit/5a28f277d1551e35c7fd717836c259badbf8a1d9))
-* include chore commits in release-please ([c437850](https://github.com/hannasdev/mcp-writing/commit/c4378501ee7dc29d582ce78bc1d227927e719810))
-* keep reusable MCP validation scripts ([65f44cb](https://github.com/hannasdev/mcp-writing/commit/65f44cb730176aa4b340c42685dccda05a6725e6))
-* keep reusable MCP validation scripts ([9d4181e](https://github.com/hannasdev/mcp-writing/commit/9d4181e32d6ba9a76a33659c5cfedfe9cf296619))
-* trigger CI for release-please branches ([09e599a](https://github.com/hannasdev/mcp-writing/commit/09e599a399e6b9e039ef2670cfa51a88518dbd56))
-
-## [1.1.0](https://github.com/hannasdev/mcp-writing/compare/v1.0.0...v1.1.0) (2026-04-16)
-
-
-### Features
-
-* reconcile Scrivener reorders via stable external IDs ([977a1c3](https://github.com/hannasdev/mcp-writing/commit/977a1c3770861b5f8b0dd9ec8bcdcb00ff39d18a))
-* stable Scrivener identity and reorder reconciliation ([14c165f](https://github.com/hannasdev/mcp-writing/commit/14c165fd80050c59e162fd35bd84cbd39b767cee))
+- chore(main): release 1.3.5 [`#20`](https://github.com/hannasdev/mcp-writing.git
+/pull/20)
+- fix(ci): force OIDC-only npm publish auth [`c9f1216`](https://github.com/hannasdev/mcp-writing.git
+/commit/c9f1216f2d3aa49fcc2aad5e6c4032962ad843d1)
+
+#### [v1.3.4](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.3...v1.3.4)
+
+> 18 April 2026
+
+- chore(main): release 1.3.4 [`#19`](https://github.com/hannasdev/mcp-writing.git
+/pull/19)
+- fix(ci): use tag trigger for npm publish (matches n8n pattern) [`#18`](https://github.com/hannasdev/mcp-writing.git
+/pull/18)
+
+#### [v1.3.3](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.2...v1.3.3)
+
+> 18 April 2026
+
+- chore(main): release 1.3.3 [`#17`](https://github.com/hannasdev/mcp-writing.git
+/pull/17)
+- fix(ci): use tag trigger for npm publish (matches n8n pattern) [`6841de7`](https://github.com/hannasdev/mcp-writing.git
+/commit/6841de78a90c3b4c121761d28a09b02f9d360a96)
+
+#### [v1.3.2](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.1...v1.3.2)
+
+> 18 April 2026
+
+- chore(main): release 1.3.2 [`#16`](https://github.com/hannasdev/mcp-writing.git
+/pull/16)
+- docs(readme): add real-world scenarios; fix publish workflow yaml [`3566905`](https://github.com/hannasdev/mcp-writing.git
+/commit/3566905d6f060eed5c35be29f73560bc4d74af27)
+- fix(ci): publish from main release commits for npm trusted publishing [`135ab25`](https://github.com/hannasdev/mcp-writing.git
+/commit/135ab254fb91ee6427a79cdecdc5b9bf55cfb4d1)
+
+#### [v1.3.1](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.3.0...v1.3.1)
+
+> 18 April 2026
+
+- chore(main): release 1.3.1 [`#15`](https://github.com/hannasdev/mcp-writing.git
+/pull/15)
+- chore: generate integration fixtures at runtime and remove test-sync [`#14`](https://github.com/hannasdev/mcp-writing.git
+/pull/14)
+- fix(ci): set npm environment for trusted publishing [`b75fb08`](https://github.com/hannasdev/mcp-writing.git
+/commit/b75fb0897dbbbd9df2d136cbb78a06218f0c0b50)
+
+#### [v1.3.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.2.0...v1.3.0)
+
+> 18 April 2026
+
+- chore(main): release 1.3.0 [`#13`](https://github.com/hannasdev/mcp-writing.git
+/pull/13)
+- feat: formalize non-draft content and stable Scrivener imports [`#12`](https://github.com/hannasdev/mcp-writing.git
+/pull/12)
+
+#### [v1.2.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.1.1...v1.2.0)
+
+> 17 April 2026
+
+- chore(main): release 1.2.0 [`#11`](https://github.com/hannasdev/mcp-writing.git
+/pull/11)
+- feat: Phase 3 git-backed prose editing, runtime config tool, startup path logging [`f30a7c8`](https://github.com/hannasdev/mcp-writing.git
+/commit/f30a7c8b5e5aaf070b0b6cfaec38479141c5f60b)
+
+#### [v1.1.1](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.1.0...v1.1.1)
+
+> 16 April 2026
+
+- chore(main): release 1.1.1 [`#9`](https://github.com/hannasdev/mcp-writing.git
+/pull/9)
+- fix: use dedicated token for release-please workflow [`#10`](https://github.com/hannasdev/mcp-writing.git
+/pull/10)
+- chore: include chore commits in release automation [`#8`](https://github.com/hannasdev/mcp-writing.git
+/pull/8)
+- chore: keep reusable MCP validation scripts [`#7`](https://github.com/hannasdev/mcp-writing.git
+/pull/7)
+- chore: trigger CI for release-please branches [`#6`](https://github.com/hannasdev/mcp-writing.git
+/pull/6)
+- chore: include chore commits in release-please [`c437850`](https://github.com/hannasdev/mcp-writing.git
+/commit/c4378501ee7dc29d582ce78bc1d227927e719810)
+- chore: fix lint in MCP validation scripts [`2b2385e`](https://github.com/hannasdev/mcp-writing.git
+/commit/2b2385e3eddd8fd30716d0f72dfa6346ec2d6e5f)
+- chore: run CI on release-please branch pushes [`856063c`](https://github.com/hannasdev/mcp-writing.git
+/commit/856063c85047c164f857f598520f57dffe215d4a)
+
+#### [v1.1.0](https://github.com/hannasdev/mcp-writing.git
+/compare/v1.0.0...v1.1.0)
+
+> 16 April 2026
+
+- chore(main): release 1.1.0 [`#5`](https://github.com/hannasdev/mcp-writing.git
+/pull/5)
+- feat: stable Scrivener identity and reorder reconciliation [`#4`](https://github.com/hannasdev/mcp-writing.git
+/pull/4)
+- chore: add ESLint, release-please, and automated npm publish [`#3`](https://github.com/hannasdev/mcp-writing.git
+/pull/3)
+- Publish to npm as @hanna84/mcp-writing [`#2`](https://github.com/hannasdev/mcp-writing.git
+/pull/2)
+- Mark package as private [`#1`](https://github.com/hannasdev/mcp-writing.git
+/pull/1)
+- chore: trigger CI checks for release PR [`5191fcc`](https://github.com/hannasdev/mcp-writing.git
+/commit/5191fccc7c9643a7d7ac32da3a407a0e512fa287)
+- Track package-lock.json; remove from gitignore [`090b0af`](https://github.com/hannasdev/mcp-writing.git
+/commit/090b0af5b8e532dc88013ae46d5cd6237221cb26)
+- chore: add ESLint, release-please, and automated npm publish workflow [`9e8f8d7`](https://github.com/hannasdev/mcp-writing.git
+/commit/9e8f8d7d4832cb1f1f0710351f9c53cf008850bb)
+
+#### v1.0.0
+
+> 16 April 2026
+
+- feat: Phase 1 scaffold — core retrieval tools, SQLite index, SSE transport [`e8bdfa0`](https://github.com/hannasdev/mcp-writing.git
+/commit/e8bdfa0001696f6bb8b10f4c69917a833ad4bc4d)
+- Extract db.js + sync.js; add unit + integration tests (40/40 pass) [`e129c0b`](https://github.com/hannasdev/mcp-writing.git
+/commit/e129c0be6208f731f0f9405133e9f5d88f171951)
+- Add thread link writes and standardize error envelopes [`4f59904`](https://github.com/hannasdev/mcp-writing.git
+/commit/4f599044a85dd740cdbc3f9f884e29c1018af4a0)

package/README.md

@@ -445,6 +445,40 @@ Unit tests use an in-memory SQLite database and temporary directories — no ser
 
 For real projects, keep your manuscript sync folder outside this tool repository and point `WRITING_SYNC_DIR` at that external path.
 
+## Release automation
+
+This repository uses a `release-it` workflow (modeled after `n8n-nodes-bambulab`) instead of Release Please.
+
+How it works:
+
+1. A PR is merged into `main`.
+2. `.github/workflows/release.yml` runs on that push.
+3. The workflow fetches tags and infers version bump type from commits since last tag:
+  - `BREAKING CHANGE` or `!:` -> major
+  - `feat:` -> minor
+  - everything else -> patch
+4. `release-it` creates a `Release x.y.z` commit and `vx.y.z` tag.
+5. Tag push triggers `.github/workflows/publish.yml` to publish to npm.
+
+Required setup:
+
+- Repository secret: `RELEASE_DEPLOY_KEY` (private SSH key for a repo deploy key with write access)
+- Optional secret: `RELEASE_DEPLOY_KNOWN_HOSTS` (additional strict host keys; GitHub host key is already handled)
+- Branch rules must allow the **Deploy Key** actor to bypass PR-only rule for release commit/tag push
+- Repository URL in `package.json` must remain valid for npm provenance
+
+Local dry-run (optional):
+
+```sh
+npm run release -- --ci --dry-run
+```
+
+Operational note:
+
+- If a release job partially succeeds by pushing a tag before failing later, do not rerun that old workflow run.
+- The workflow now fails fast when `package.json` is behind the latest tag, which indicates a stale rerun.
+- In that case, trigger the next release from current `main` instead of retrying the old run.
+
 ## Troubleshooting
 
 ### "Module not found: sqlite" or "Database support not available"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanna84/mcp-writing",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "MCP service for AI-assisted reasoning and editing on long-form fiction projects",
   "type": "module",
   "main": "index.js",
@@ -20,6 +20,7 @@
   "scripts": {
     "start": "node --experimental-sqlite index.js",
     "new:entity": "node scripts/new-world-entity.js",
+    "release": "release-it",
     "lint": "eslint index.js db.js sync.js metadata-lint.js scripts/",
     "lint:metadata": "node scripts/lint-metadata.mjs",
     "test:unit": "node --experimental-sqlite --test test/unit.test.mjs",
@@ -48,7 +49,9 @@
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
+    "auto-changelog": "^2.5.0",
     "eslint": "^10.2.0",
-    "globals": "^17.5.0"
+    "globals": "^17.5.0",
+    "release-it": "^20.0.0"
   }
 }