@hanna84/mcp-writing 3.1.0 → 3.1.2

package/CHANGELOG.md

@@ -4,11 +4,31 @@ 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.1.2](https://github.com/hannasdev/mcp-writing.git
+/compare/v3.1.1...v3.1.2)
+
+- refactor: move styleguide skill output to skills/prose-styleguide/SKILL.md [`#168`](https://github.com/hannasdev/mcp-writing.git
+/pull/168)
+
+#### [v3.1.1](https://github.com/hannasdev/mcp-writing.git
+/compare/v3.1.0...v3.1.1)
+
+> 3 May 2026
+
+- fix: surface runtime warning for invalid PROSE_STYLEGUIDE_ENFORCEMENT_MODE [`#167`](https://github.com/hannasdev/mcp-writing.git
+/pull/167)
+- Release 3.1.1 [`0531168`](https://github.com/hannasdev/mcp-writing.git
+/commit/0531168d60bde6f445a3465b3f4246fdca53bfba)
+
 #### [v3.1.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v3.0.0...v3.1.0)
 
+> 2 May 2026
+
 - feat(editing): enforce styleguide automatically in edit flow [`#166`](https://github.com/hannasdev/mcp-writing.git
 /pull/166)
+- Release 3.1.0 [`ad1106c`](https://github.com/hannasdev/mcp-writing.git
+/commit/ad1106ca4099777d9b05556dfd9cf75de4f030f1)
 
 ### [v3.0.0](https://github.com/hannasdev/mcp-writing.git
 /compare/v2.18.1...v3.0.0)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanna84/mcp-writing",
-  "version": "3.1.0",
+  "version": "3.1.2",
   "description": "MCP service for AI-assisted reasoning and editing on long-form fiction projects",
   "homepage": "https://hannasdev.github.io/mcp-writing/",
   "type": "module",

package/src/index.js

@@ -78,6 +78,7 @@ const STYLEGUIDE_ENFORCEMENT_MODE = STYLEGUIDE_ENFORCEMENT_MODE_RAW === "off"
   ? STYLEGUIDE_ENFORCEMENT_MODE_RAW
   : "warn";
 const OWNERSHIP_GUARD_MODE_RAW_DISPLAY = JSON.stringify(OWNERSHIP_GUARD_MODE_RAW);
+const STYLEGUIDE_ENFORCEMENT_MODE_RAW_DISPLAY = JSON.stringify(STYLEGUIDE_ENFORCEMENT_MODE_RAW);
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 const ROOT_DIR = path.resolve(__dirname, "..");
@@ -219,6 +220,9 @@ const RUNTIME_DIAGNOSTICS = getRuntimeDiagnostics({
   ownershipGuardModeRaw: OWNERSHIP_GUARD_MODE_RAW,
   ownershipGuardMode: OWNERSHIP_GUARD_MODE,
   ownershipGuardModeRawDisplay: OWNERSHIP_GUARD_MODE_RAW_DISPLAY,
+  styleguideEnforcementModeRaw: STYLEGUIDE_ENFORCEMENT_MODE_RAW,
+  styleguideEnforcementMode: STYLEGUIDE_ENFORCEMENT_MODE,
+  styleguideEnforcementModeRawDisplay: STYLEGUIDE_ENFORCEMENT_MODE_RAW_DISPLAY,
   syncDirWritable: SYNC_DIR_WRITABLE,
   syncDirAbs: SYNC_DIR_ABS,
   syncOwnershipDiagnostics: SYNC_OWNERSHIP_DIAGNOSTICS,

package/src/runtime/runtime-diagnostics.js

@@ -6,9 +6,12 @@
  * is straightforward to test.
  *
  * @param {object} opts
- * @param {string}  opts.ownershipGuardModeRaw      Raw env value before normalisation
+ * @param {string}  opts.ownershipGuardModeRaw      Trimmed/lowercased env token before enum validation
  * @param {string}  opts.ownershipGuardMode          Normalised value ("warn" | "fail")
  * @param {string}  opts.ownershipGuardModeRawDisplay JSON.stringify of the raw value
+ * @param {string}  opts.styleguideEnforcementModeRaw Trimmed/lowercased env token before enum validation
+ * @param {string}  opts.styleguideEnforcementMode    Normalised value ("off" | "warn" | "required")
+ * @param {string}  opts.styleguideEnforcementModeRawDisplay JSON.stringify of the raw value
  * @param {boolean} opts.syncDirWritable
  * @param {string}  opts.syncDirAbs                 Resolved absolute path shown in messages
  * @param {object}  opts.syncOwnershipDiagnostics   Result of getSyncOwnershipDiagnostics()
@@ -20,6 +23,9 @@ export function getRuntimeDiagnostics({
   ownershipGuardModeRaw,
   ownershipGuardMode,
   ownershipGuardModeRawDisplay,
+  styleguideEnforcementModeRaw,
+  styleguideEnforcementMode,
+  styleguideEnforcementModeRawDisplay,
   syncDirWritable,
   syncDirAbs,
   syncOwnershipDiagnostics,
@@ -36,6 +42,13 @@ export function getRuntimeDiagnostics({
     recommendations.push("Set OWNERSHIP_GUARD_MODE to either 'warn' or 'fail'.");
   }
 
+  if (styleguideEnforcementModeRaw !== styleguideEnforcementMode) {
+    warnings.push(
+      `STYLEGUIDE_ENFORCEMENT_MODE_INVALID: Unsupported PROSE_STYLEGUIDE_ENFORCEMENT_MODE=${styleguideEnforcementModeRawDisplay}. Falling back to 'warn'.`
+    );
+    recommendations.push("Set PROSE_STYLEGUIDE_ENFORCEMENT_MODE to one of 'off', 'warn', or 'required'.");
+  }
+
   if (syncOwnershipDiagnostics.runtime_uid_override_ignored) {
     warnings.push("RUNTIME_UID_OVERRIDE_IGNORED: RUNTIME_UID_OVERRIDE is ignored unless NODE_ENV=test or ALLOW_RUNTIME_UID_OVERRIDE=1.");
     recommendations.push("Avoid RUNTIME_UID_OVERRIDE in production runtime environments.");

package/src/styleguide/prose-styleguide-skill.js

@@ -1,5 +1,5 @@
-export const PROSE_STYLEGUIDE_SKILL_DIRNAME = "skills";
-export const PROSE_STYLEGUIDE_SKILL_BASENAME = "prose-styleguide.md";
+export const PROSE_STYLEGUIDE_SKILL_DIRNAME = "skills/prose-styleguide";
+export const PROSE_STYLEGUIDE_SKILL_BASENAME = "SKILL.md";
 
 const LANGUAGE_LABELS = {
   english_us: "English (US)",
@@ -63,7 +63,7 @@ export function buildProseStyleguideSkill({ resolvedConfig, sources = [], projec
       ok: false,
       error: {
         code: "INVALID_STYLEGUIDE_CONFIG",
-        message: "Cannot generate prose-styleguide.md without a resolved config object.",
+        message: "Cannot generate skills/prose-styleguide/SKILL.md without a resolved config object.",
       },
     };
   }

package/src/tools/editing.js

@@ -73,7 +73,7 @@ function resolveStyleguideSnapshot({ syncDir, projectId, errorResponse }) {
       ok: false,
       response: errorResponse(
         "STYLEGUIDE_SKILL_IO_ERROR",
-        "Failed to read skills/prose-styleguide.md while resolving styleguide snapshot.",
+        "Failed to read skills/prose-styleguide/SKILL.md while resolving styleguide snapshot.",
         {
           file_path: skillPath,
           reason: err.message,
@@ -147,14 +147,14 @@ function evaluateStyleguidePolicy({
           ok: false,
           response: errorResponse(
             "STYLEGUIDE_SKILL_REQUIRED",
-            "Cannot propose prose edits before skills/prose-styleguide.md exists.",
+            "Cannot propose prose edits before skills/prose-styleguide/SKILL.md exists.",
             {
               next_step: "Run setup_prose_styleguide_skill, then retry propose_edit.",
             }
           ),
         };
       }
-      warnings.push("skills/prose-styleguide.md was not found at sync root.");
+      warnings.push("skills/prose-styleguide/SKILL.md was not found at sync root.");
     }
   }
 

package/src/tools/styleguide.js

@@ -603,10 +603,10 @@ export function registerStyleguideTools(s, {
 
   s.tool(
     "setup_prose_styleguide_skill",
-    "Generate skills/prose-styleguide.md from the resolved prose styleguide config and universal craft rules.",
+    "Generate skills/prose-styleguide/SKILL.md from the resolved prose styleguide config and universal craft rules.",
     {
       project_id: z.string().optional().describe("Optional project ID for scoped config resolution (e.g. 'the-lamb' or 'universe-1/book-1')."),
-      overwrite: z.boolean().optional().describe("If true, replaces an existing skills/prose-styleguide.md file."),
+      overwrite: z.boolean().optional().describe("If true, replaces an existing skills/prose-styleguide/SKILL.md file."),
     },
     async ({ project_id, overwrite = false }) => {
       if (project_id !== undefined) {
@@ -638,7 +638,7 @@ export function registerStyleguideTools(s, {
       if (resolved.setup_required || !resolved.resolved_config) {
         return errorResponse(
           "STYLEGUIDE_CONFIG_REQUIRED",
-          "Cannot generate prose-styleguide.md before prose-styleguide.config.yaml is set up.",
+          "Cannot generate skills/prose-styleguide/SKILL.md before prose-styleguide.config.yaml is set up.",
           {
             project_id: project_id ?? null,
             next_step: "Run setup_prose_styleguide_config or bootstrap_prose_styleguide_config first.",
@@ -658,7 +658,7 @@ export function registerStyleguideTools(s, {
       if (fs.existsSync(skillPath) && !overwrite) {
         return errorResponse(
           "STYLEGUIDE_SKILL_EXISTS",
-          "skills/prose-styleguide.md already exists. Set overwrite=true to replace it.",
+          "skills/prose-styleguide/SKILL.md already exists. Set overwrite=true to replace it.",
           { target_path: path.resolve(skillPath) }
         );
       }