@hanna84/mcp-writing 3.17.0 → 3.17.2

package/CHANGELOG.md

@@ -4,9 +4,23 @@ All notable changes to this project will be documented in this file. Dates are d
 
 Generated by [`auto-changelog`](https://github.com/CookPete/auto-changelog).
 
+#### [v3.17.2](https://github.com/hannasdev/mcp-writing/compare/v3.17.1...v3.17.2)
+
+- docs: complete Docker deployment readiness [`#216`](https://github.com/hannasdev/mcp-writing/pull/216)
+
+#### [v3.17.1](https://github.com/hannasdev/mcp-writing/compare/v3.17.0...v3.17.1)
+
+> 23 May 2026
+
+- docs: add database backup recovery initiative [`#215`](https://github.com/hannasdev/mcp-writing/pull/215)
+- Release 3.17.1 [`a0fa16c`](https://github.com/hannasdev/mcp-writing/commit/a0fa16cac37add24dc1fbcaecd3c4301e9ee2873)
+
 #### [v3.17.0](https://github.com/hannasdev/mcp-writing/compare/v3.16.0...v3.17.0)
 
+> 23 May 2026
+
 - feat: support runnable Docker workflow [`#213`](https://github.com/hannasdev/mcp-writing/pull/213)
+- Release 3.17.0 [`136c384`](https://github.com/hannasdev/mcp-writing/commit/136c3841b58d92a8f265cf3e53d1d9ca4a160b3b)
 
 #### [v3.16.0](https://github.com/hannasdev/mcp-writing/compare/v3.15.1...v3.16.0)
 

package/README.md

@@ -28,8 +28,9 @@ Instead of feeding an entire manuscript to an AI and hoping it fits in the conte
 
 **Current status:**
 - **Core platform complete:** Metadata-first analysis, sidecar-backed metadata maintenance, AI-assisted prose editing with confirmation + git history, review bundles, and Scrivener Direct extraction are all implemented.
-- **Recently completed:** Filesystem Boundary Hardening centralized local file mutation through application-aware helpers and lint guardrails.
-- **Active development:** Docker, CI, and Deployment Workflow is making Docker a supported way to build, run, smoke-test, and deploy Writing MCP.
+- **Recently completed:** Docker, CI, and Deployment Workflow made Docker a supported way to build, run, smoke-test, and deploy Writing MCP.
+- **Previous milestone:** Filesystem Boundary Hardening centralized local file mutation through application-aware helpers and lint guardrails.
+- **Active development:** No active initiative is currently selected.
 - **Deferred backlog:** OpenClaw integration, client-agnostic setup, chapter-structure follow-up, and embeddings search.
 - **Ideas and open questions:** tracked separately so future exploration does not distort the active roadmap.
 
@@ -45,7 +46,7 @@ Instead of feeding an entire manuscript to an AI and hoping it fits in the conte
 |---|---|
 | [docs/guides/setup.md](docs/guides/setup.md) | Prerequisites, first-time setup, Scrivener import, native sync format |
 | [mcp-writing-vscode](https://github.com/hannasdev/mcp-writing-vscode) | VS Code extension for client-native setup flows |
-| [docs/guides/docker.md](docs/guides/docker.md) | Docker Compose, OpenClaw integration, SSH hardening |
+| [docs/guides/docker.md](docs/guides/docker.md) | Docker Compose, deployment operations, MCP gateway notes |
 | [docs/foundations/managed-structure-contract.md](docs/foundations/managed-structure-contract.md) | Design boundaries for structural mutation, generated views, import, and maintenance workflows |
 | [docs/agents/tools.md](docs/agents/tools.md) | Full tool reference — auto-generated from source |
 | [docs/agents/README.md](docs/agents/README.md) | Index of agent-focused guidance, examples, and boot files |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanna84/mcp-writing",
-  "version": "3.17.0",
+  "version": "3.17.2",
   "description": "MCP service for AI-assisted reasoning and editing on long-form fiction projects",
   "homepage": "https://hannasdev.github.io/mcp-writing/",
   "type": "module",
@@ -73,9 +73,10 @@
     "release": "release-it",
     "lint": "eslint *.js eslint-rules src/index.js src/core src/review-bundles src/runtime src/setup src/scripts src/structure src/styleguide src/sync src/tools src/workflows src/world",
     "guard:legacy-root-imports": "node src/scripts/check-legacy-root-imports.mjs",
+    "guard:docker-docs": "node src/scripts/check-docker-docs.mjs",
     "docs": "node src/scripts/generate-tool-docs.mjs",
     "check:docs": "npm run docs && git diff --exit-code -- docs/agents/tools.md",
-    "check:static": "npm run lint && npm run guard:legacy-root-imports && npm run check:docs",
+    "check:static": "npm run lint && npm run guard:legacy-root-imports && npm run guard:docker-docs && npm run check:docs",
     "check:pr": "npm run check:static && npm test",
     "lint:metadata": "node src/scripts/lint-metadata.mjs",
     "sync:server-json-version": "node src/scripts/sync-server-json-version.mjs",

package/src/scripts/check-docker-docs.mjs

@@ -0,0 +1,77 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../..");
+
+const dockerfile = fs.readFileSync(path.join(ROOT, "Dockerfile"), "utf8");
+const compose = fs.readFileSync(path.join(ROOT, "docker-compose.example.yml"), "utf8");
+const guide = fs.readFileSync(path.join(ROOT, "docs", "guides", "docker.md"), "utf8");
+
+const requiredDocSnippets = [
+  "`WRITING_SYNC_DIR`",
+  "`DB_PATH`",
+  "`HTTP_PORT`",
+  "`MCP_TRANSPORT`",
+  "`OWNERSHIP_GUARD_MODE`",
+  "`/sync`",
+  "`/data`",
+  "`/ssh`",
+  "Upgrade Checklist",
+  "Backup Checklist",
+  "Rollback",
+  "Supported Deployment Targets",
+  "OpenClaw",
+];
+
+const requiredComposeSnippets = [
+  "WRITING_SYNC_DIR: /sync",
+  "DB_PATH: /data/writing.db",
+  "HTTP_PORT: \"3000\"",
+  "OWNERSHIP_GUARD_MODE:",
+  "MCP_TRANSPORT: http",
+  "${WRITING_SYNC_DIR_HOST:-./sync}:/sync",
+  "${WRITING_DATA_DIR_HOST:-./data}:/data",
+  "WRITING_SSH_DIR_HOST",
+  "GIT_SSH_COMMAND",
+];
+
+const requiredDockerfileSnippets = [
+  "ENV WRITING_SYNC_DIR=/sync",
+  "ENV DB_PATH=/data/writing.db",
+  "ENV HTTP_PORT=3000",
+  "ENV MCP_TRANSPORT=http",
+  "git openssh-client",
+  "HEALTHCHECK",
+  "/healthz",
+];
+
+const findings = [];
+
+function requireSnippet(label, content, snippet) {
+  if (!content.includes(snippet)) {
+    findings.push(`${label} is missing ${JSON.stringify(snippet)}`);
+  }
+}
+
+for (const snippet of requiredDocSnippets) {
+  requireSnippet("docs/guides/docker.md", guide, snippet);
+}
+
+for (const snippet of requiredComposeSnippets) {
+  requireSnippet("docker-compose.example.yml", compose, snippet);
+}
+
+for (const snippet of requiredDockerfileSnippets) {
+  requireSnippet("Dockerfile", dockerfile, snippet);
+}
+
+if (findings.length > 0) {
+  console.error("Docker docs drift check failed:");
+  for (const finding of findings) {
+    console.error(`- ${finding}`);
+  }
+  process.exit(1);
+}
+
+console.log("Docker docs drift check passed.");